TiddlyWiki5/bin
Jeremy Ruston a9f9ffd409
Introduce Tour Plugin and Confetti Plugin, improve Dynannotate Plugin (#7734)
* First commit

* Typo

* Add support for delay parameter

* Add confetti widget

* Add tour plugin

* Add element spotlight to dynannotate plugin

Useful for highlighting on screen elements for the user

* More and bigger confetti by default

* Use new element spotlight to provide hints

* Adjust hint selectors for create tiddler tour step

* Include confetti plugin in prerelease

* Clarify wording of confetti demo

* Don't link TiddlyWiki in the tour panel

* Tweaks to tour buttons

* Mark dependents of the tour plugin

* Add full screen section of tour and tour edition

* Remove Anna Freud references from welcome tiddler

* Build the tour edition in the preview

* Fix typo in build script

* Populate tour edition with solar system data

From Simple English Wikipedia

* Missing tag

* Add page control button to start tour

Also make the tour controls visible in full screen mode

* Refactor to use global procedures to control the tour

* Change "startup-actions" field to "enter-actions" to avoid confusion

* Add a tour logo

* Refactor to allow multiple tours to be loaded at once

* Remove wikification from welcome tour step

* Update docs

* Simplify styles for top bar

* Tours should have a $:/tags/Tour tag

* Tour should autostart in the tour edition, but not in the main wiki

* Better labelling for the main preview

* Fix build process

We build a separate tour.html wiki, but can include the tour in other wikis too

* Remove obsolete text

* Add "using tags" as a separate tour

* Remove old debugging code

* Add tour chooser

* Ensure that the current tour isn't listed as an option in the final step

* Use whitespace trim

Note that the setting is inherited by procedure and widget definitions

* Simplify tour step format

* Remove obsolete state tiddler

Not needed because now we initialise it in startup actions

* Fix gap between navigation buttons

* Clean up tiddler titles within the introduction tour

* Finish allowing the name "TiddlyWiki" to be customised

Some of the code was in the previous commit. Next we'll wire up the user interface

* Clarify docs

* Add a settings pane giving a birds eye view of a tour

* Avoid having to embed confetti in the final step

* Update docs

* Tweak styling of tour chooser dropdown

* Add a button to launch tour steps directly, and give them captions

* Expose custom tour settings

* Use the tour step caption as the heading

* Fix initialisation when jumping to a tour step

* Introduce step about tags

* Improve wording

* Improve styling of task call-to-action and nav buttons

* Adopt new conditional shortcut syntax

* Wording and ordering tweaks

* Fix typos

Thanks @pmario

* Simplify styling of tour overlay

* Use custom palette colours

Makes it easier for people to use their own colour scheme for the tour

* More custom colours

* Tour wording tweaks

* Extends the tour plugin with a condition field (#7861)

* feat: support condition field to determine whether a step should be shown

* feat: add support for overriding the hint text using the field 'hint' from the step tiddler

* fix: roll back tour display procedure for now until an override mechanism has been discussed

* fix: renamed advance-criterion field and associated variables to step-success-filter

* fix: renamed hint field to hint-text and selector to hint-selector

* refactor: to create function to get all tour tiddlers filtered by their condition field

* refactor: rename globals tiddlers to variables and avoid making any of the tour procedures global

* fix: also rename globals.tid file to variables.tid

* docs: cover all tour steps tiddler fields

* fix: improve spacing in Tour HUD

* WIP

---------

Co-authored-by: Jeremy Ruston <174761+Jermolene@users.noreply.github.com>
Co-authored-by: Saq Imtiaz <saq.imtiaz@gmail.com>
2024-01-25 12:53:35 +00:00
..
build-site.sh Introduce Tour Plugin and Confetti Plugin, improve Dynannotate Plugin (#7734) 2024-01-25 12:53:35 +00:00
build-tw-org.sh Revert "CI: Only commit if there are changes" 2022-04-01 21:01:33 +01:00
ci-pre-build.sh Add GitHub Actions workflow (#4793) 2020-08-28 17:31:57 +01:00
ci-push.sh Revert "CI: Only commit if there are changes" 2022-04-01 21:01:33 +01:00
ci-test.sh Make unit tests run faster in Github Actions (#7829) 2023-11-02 08:44:29 +00:00
clean.sh Fix clean.sh 2023-04-10 21:03:26 +01:00
get-plugin-library-version-number CI: Fix plugin library version and build test.html 2019-01-08 10:34:50 +00:00
ginsu.cmd Move scripts into bin directory 2014-09-08 16:32:34 +01:00
ginsu.sh Move scripts into bin directory 2014-09-08 16:32:34 +01:00
lazy.cmd Move scripts into bin directory 2014-09-08 16:32:34 +01:00
lazy.sh Fix `lazy.sh` to serve the edition *tw5.com-server* 2016-08-16 15:46:53 +01:00
npm-publish.sh Bring over remaining scripts from build.jermolene.github.io 2019-08-09 10:30:26 +01:00
optimise-svgs.js Update SVG optimiser script 2021-04-16 09:20:39 +01:00
quick-bld.sh Include empty.html in the quick build 2019-09-24 13:23:21 +01:00
readme-bld.sh Add new readme build script, and update the readme build 2019-07-02 16:53:23 +01:00
readme.md Add new readme build script, and update the readme build 2019-07-02 16:53:23 +01:00
serve.cmd Fix typo 2014-10-12 16:57:01 +01:00
serve.sh Fix typo 2014-10-12 16:57:01 +01:00
tankbld.cmd Move scripts into bin directory 2014-09-08 16:32:34 +01:00
tankbld.sh Move scripts into bin directory 2014-09-08 16:32:34 +01:00
test.cmd Update test.cmd 2014-10-16 10:00:55 +01:00
test.sh Jasmine command (#6944) 2022-11-20 17:54:18 +00:00
update-translation-from-html-file.sh Add script for updating language plugins from translators edition 2020-06-16 14:57:58 +01:00
verbump.sh Bring over remaining scripts from build.jermolene.github.io 2019-08-09 10:30:26 +01:00

readme.md

Script Files

The TiddlyWiki5 repository contains several scripts in the bin folder that you can use to automate common tasks, or as a useful starting point for your own scripts. See Scripts for building tiddlywiki.com for details of the scripts used to build and release https://tiddlywiki.com/.

All the scripts expect to be run from the root folder of the repository.

serve: serves tw5.com

./bin/serve.sh -h
./bin/serve.sh [edition dir] [username] [password] [host] [port]

Or:

./bin/serve.cmd -h
./bin/serve.cmd [edition dir] [username] [password] [host] [port]

This script starts TiddlyWiki5 running as an HTTP server, defaulting to the content from the tw5.com-server edition. By default, the Node.js serves on port 8080. If the optional username parameter is provided, it is used for signing edits. If the password is provided then HTTP basic authentication is used. Run the script with the -h parameter to see online help.

To experiment with this configuration, run the script and then visit http://127.0.0.1:8080 in a browser.

Changes made in the browser propagate to the server over HTTP (use the browser developer console to see these requests). The server then syncs changes to the file system (and logs each change to the screen).

test: build and run tests

This script runs the test edition of TiddlyWiki on the server to perform the server-side tests and to build test.html for running the tests in the browser.

lazy: serves tw5.com with lazily loaded images

./bin/lazy.sh <username> [<password>]

Or:

./bin/lazy.cmd <username> [<password>]

This script serves the tw5.com-server edition content with LazyLoading applied to images.