| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,25 +1,31 @@ | ||
| created: 20131129092604900 | ||
| creator: pmario | ||
| modified: 20141012120259664 | ||
| modifier: pmario | ||
| tags: howto | ||
| title: Speichern mit Chrome | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| Diese Methode ist etwas umständlich, da man Einstellungen immer wieder manuell vornehmen muss. Der Vorteil ist, dass diese Methode jedoch mit fast allen Desktop- und vielen mobilen Browsern funktioniert. | ||
|
|
||
| !! Video | ||
|
|
||
| <iframe width="560" height="315" src="http://www.youtube.com/embed/LcoZ7hQCuFI" frameborder="0" allowfullscreen></iframe> | ||
|
|
||
| !! Speichern mit Chrome | ||
|
|
||
| # Speichern Sie eine leere Datei der deutschen Version. | ||
| #> {{$:/editions/de-AT-DE/snippets/download-empty-button}} | ||
| #> Wenn der Button nicht funktioniert, dann klicken Sie den Link mit der rechten Maustaste und wählen: "Ziel Speichern unter ..." http://tiddlywiki.com/languages/de-AT/empty.html oder http://tiddlywiki.com/languages/de-DE/empty.html | ||
| #> Je nach Browser folgen Sie den Dialogen! | ||
| # Suchen Sie die eben geladene Datei im Datei Manager. | ||
| #* Geben Sie der Datei einen vernünftigen Namen und stellen Sie sicher, dass die Endung `.html` oder `.htm` ist. | ||
| # Öffnen Sie die Datei mit Ihrem Browser. | ||
| # Erstellen Sie einen neuen Tiddler mit dem {{$:/core/images/new-button}} ''plus'' im rechten Menü. | ||
| # Geben Sie den Text ein und bestätigen die Eingabe mit dem {{$:/core/images/done-button}} ''OK''. | ||
| # Speichern Sie die Änderungen mit: {{$:/core/images/save-button}} ''speichern'' im rechten Menü | ||
| # Der Browser wird nun eine neue Datei laden, die die Änderungen enthält. | ||
| # Suchen Sie die eben geladene Datei im Datei Manager. | ||
| # Überprüfen sie, ob die Änderungen richtig gespeichert wurden. | ||
|
|
||
| ''Tip'': Die meisten Browser haben eine Einstellung, dass der "Datei Speichern" Dialog immer angezeigt wird. Das ermöglicht Ihnen, die bestehende Datei auszuwählen und zu überschreiben. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,3 @@ | ||
| title: ReadMe for build.jermolene.github.io | ||
|
|
||
| {{Scripts for building tiddlywiki.com}} |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,23 @@ | ||
| title: Releasing a new version of TiddlyWiki | ||
|
|
||
| # Move the latest release note from the prerelease edition into the tw5.com edition | ||
| # Adjust the release date of the latest release tiddler (eg, [[Release 5.1.3]]) | ||
| # Ensure [[Releases]] has the new version as the default tab | ||
| # Adjust the modified time of HelloThere | ||
| # Make sure ''Jermolene/TiddlyWiki5'' is fully committed | ||
| # Edit `package.json` to the new version number | ||
| # Run `../build.jermolene.github.io/readme-bld.sh` to build the readme files | ||
| # Commit the new readme files in `TiddlyWiki5` | ||
| # Restore `package.json` to the previous version number | ||
| # Run `../build.jermolene.github.io/verbump "5.1.3"` (substituting the correct version number) to update the version number, assign it a tag | ||
| # Run `../build.jermolene.github.io/npm-publish.sh` to publish the release to npm | ||
| # Update the `package.json` for `build.jermolene.github.io` to the new version | ||
| # Verify that the new release of TiddlyWiki is available at https://www.npmjs.org/package/tiddlywiki | ||
| # Check the version number of TiddlyWiki specified in `build.jermolene.github.io/package.json` is the latest version | ||
| # Change current directory to the `build.jermolene.github.io` directory | ||
| # Run `npm install` to install the correct version of TiddlyWiki | ||
| # Change current directory to the `TiddlyWiki5` directory | ||
| # Run `../build.jermolene.github.io/bld.sh` to build the content files | ||
| # Verify that the files in the `jermolene.github.io` directory are correct | ||
| # Run `../build.jermolene.github.io/github-push.sh` to push the new files to GitHub | ||
| # Run `../build.jermolene.github.io/tiddlyspace-upload.sh <username> <password>` to upload the release to TiddlySpace |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| title: Releasing new content for TiddlyWiki | ||
|
|
||
| # Change current directory to the `TiddlyWiki5` directory | ||
| # Run `../build.jermolene.github.io/bld.sh` to build the content files | ||
| # Run `../build.jermolene.github.io/readme-bld.sh` to build the readmes | ||
| # Commit the readmes to `TiddlyWiki5` and `build.jermolene.github.io` if necessary | ||
| # Verify that the files in the `jermolene.github.io` directory are correct | ||
| # Run `../build.jermolene.github.io/github-push.sh` to push the new files to GitHub |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,94 @@ | ||
| title: Scripts for building tiddlywiki.com | ||
|
|
||
| These scripts are used to build and release the content for tiddlywiki.com. They are not designed for general purpose use -- they resolve problems that are specific to the task of building tiddlywiki.com: pushing to GitHub Pages, handling the prerelease builds and bumping version numbers. | ||
|
|
||
| Nonetheless, you may find techniques that are useful for your own scripts. | ||
|
|
||
| ! Hosting | ||
|
|
||
| http://tiddlywiki.com is served by [[GitHub Pages|https://pages.github.com]] from the repository https://github.com/Jermolene/jermolene.github.io | ||
|
|
||
| The scripts live in the repository https://github.com/Jermolene/build.jermolene.github.io | ||
|
|
||
| ! Directory structure | ||
|
|
||
| These scripts require the following directories to be siblings: | ||
|
|
||
| * `build.jermolene.github.io` - a local copy of https://github.com/Jermolene/build.jermolene.github.io | ||
| * `jermolene.github.io` - a local copy of the repo https://github.com/Jermolene/jermolene.github.io | ||
| * `TiddlyWiki5` - a local copy of the repo https://github.com/Jermolene/TiddlyWiki5 | ||
|
|
||
| The scripts are designed to be executed with the current directory being the `TiddlyWiki5` directory. | ||
|
|
||
| ! Configuration | ||
|
|
||
| !! package.json | ||
|
|
||
| The `package.json` in the root of the `build.jermolene.github.io` repository contains a dependency declaration that specifies the latest official released version of TiddlyWiki to be used when building the release targets: | ||
|
|
||
| ``` | ||
|
|
||
| "dependencies": { | ||
| "tiddlywiki": "5.1.2" | ||
| } | ||
| ``` | ||
|
|
||
| !! Environment variables | ||
|
|
||
| Some of the scripts use the following environment variables: | ||
|
|
||
| * ''TW5_BUILD_MAIN_EDITION'' - the path to the wiki folder to be used as the main edition, generating `index.html` and `encrypted.html` | ||
| * ''TW5_BUILD_OUTPUT'' - the path to the output folder (defaults to `../jermolene.github.io`) | ||
| * ''TW5_BUILD_TIDDLYWIKI'' - the pathname of the `tiddlywiki.js` to be used (defaults to `../build.jermolene.github.io/node_modules/tiddlywiki/tiddlywiki.js`) | ||
|
|
||
| ! Scripts | ||
|
|
||
| !! `bld.sh` | ||
|
|
||
| Builds the `tiddlywiki.com` target files. By default, it uses the version of tiddlywiki specified in the `package.json` file. This can be overridden with the ''TW5_BUILD_TIDDLYWIKI'' environment variable. The following command would select the latest prerelease version of tiddlywiki from the `TiddlyWiki5` directory: | ||
|
|
||
| ``` | ||
| TW5_BUILD_TIDDLYWIKI=./tiddlywiki.js | ||
| ``` | ||
|
|
||
| !! `readme-bld.sh` | ||
|
|
||
| Builds the readme files for the `TiddlyWiki5` and `build.jermolene.github.io` repos using the released version of TiddlyWiki specified in `package.json`. | ||
|
|
||
| !! `prerelease-bld.sh` | ||
|
|
||
| Builds the `tiddlywiki.com/prerelease` target files using the latest TiddlyWiki prerelease code and special ''prerelease'' edition for the content. | ||
|
|
||
| !! `github-push.sh` | ||
|
|
||
| Pushes the latest changes to the `jermolene.github.io` directory to GitHub. | ||
|
|
||
| !! `dev-bld.sh` | ||
|
|
||
| Builds the ''dev'' prerelease edition. | ||
|
|
||
| !! `quick-bld.sh` | ||
|
|
||
| Builds the ''prerelease'' prerelease edition. | ||
|
|
||
| !! `tiddlyspace-upload.sh` | ||
|
|
||
| Builds the ''tw5tiddlyweb'' edition and uploads it to TiddlySpace. | ||
|
|
||
| !! `verbump.sh` | ||
|
|
||
| Bumps the version number of the `package.json` in the `TiddlyWiki5` repo and applies the correct version tag to the repo. | ||
|
|
||
| !! `npm-publish.sh` | ||
|
|
||
| Publishes the `TiddlyWiki5` repo to npm. | ||
|
|
||
| ! Procedures | ||
|
|
||
| !! Releasing a new version of TiddlyWiki | ||
|
|
||
| {{Releasing a new version of TiddlyWiki}} | ||
|
|
||
| !! Releasing new content for TiddlyWiki | ||
|
|
||
| {{Releasing new content for TiddlyWiki}} |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,22 @@ | ||
| created: 20141016083308219 | ||
| modified: 20141016083333808 | ||
| title: Contributing to the TiddlyWiki Core | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| The TiddlyWiki core is the container for all the generic features of TiddlyWiki that are of universal utility. Concretely, it comprises the tiddlers in the `$:/core` plugin. | ||
|
|
||
| ! Core Contribution Requirements | ||
|
|
||
| There are requirements that must be met for any contribution that is to be accepted into the core: | ||
|
|
||
| * If appropriate, the new functionality must support both standalone and Node.js configurations. For example, any new widgets must be capable of being rendered on the server | ||
| * The contribution must not compromise the backwards compatibility of the existing code | ||
| * Code contributions must comply with the [[TiddlyWiki Coding Style Guidelines]] | ||
| * Generic components are preferred over point solutions for specific problems (which belong in plugins) | ||
|
|
||
| ! The Core and Innovation | ||
|
|
||
| If you've created something new and innovative, don't try to rush to get it included into the core. Once new stuff is in the core it is subject to the core policies of strict backwards compatibility, making it frozen as far as radical innovation is concerned. It's usually better to release the new thing as a plugin so that it can be shared with the rest of the community for feedback. | ||
|
|
||
| The expected model of innovation is that the core development will move relatively slowly as more and more of the initial planned functionality is implemented. Innovation can take place in the much more unconstrained environment of plugins. Over time, as these third party plugins gain popularity and become more polished, some or all of their functionality will be migrated into the core. | ||
|
|
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,14 @@ | ||
| created: 20141016083308219 | ||
| modified: 20141016083333808 | ||
| title: Contributing to the TiddlyWiki Plugin Library | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| The TiddlyWiki Plugin library is the set of plugins, themes and languages that are distributed via http://tiddlywiki.com. | ||
|
|
||
| The plugin library is intended to help end users of TiddlyWiki in the following ways: | ||
|
|
||
| * By being a reliable, official source of community assets | ||
| * Permitting automatic upgrading of plugins during the upgrade process | ||
| * Providing a guarantee of backwards compatibility | ||
|
|
||
| Plugins in the library need a maintainer who is prepared to make a commitment to keep them tested and fully operational with successive releases of the core code. Many plugins are maintained by the core team. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| title: FakeDomMechanism | ||
| modified: 20141019122342995 | ||
|
|
||
| The "fake DOM" is a simplified JavaScript implementation of the DOM that can be run on the server. Its use allows modules that need to run under Node.js to generate and manipulate HTML through the DOM API, rather than having to stitch HTML strings together. | ||
|
|
||
| The fake DOM only implements a small subset of the full DOM APIs but it is sufficient for the core widgets to be able to be run under Node.js. | ||
|
|
||
| Because the fake DOM is faster than the real DOM, it is also used in the browser when interactive rendering to the DOM isn't needed. The best example is stylesheet processing, where WikiText stylesheet content is parsed and rendered, and the plain text extracted from the fake DOM for use as the stylesheet content. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,15 @@ | ||
| title: How to customise the password prompt | ||
| tags: howto | ||
| created: 20141006085526118 | ||
| modified: 20141006085526118 | ||
|
|
||
| You can customise the text and appearance of the password prompt that is displayed when encrypted TiddlyWiki files are first opened. | ||
|
|
||
| To do so, create a tiddler tagged {{$:/core/wiki/rawmarkup|$:/core/ui/TagTemplate}} containing: | ||
|
|
||
| # A JavaScript `<script>` tag containing code to override the configuration variable `$tw.boot.encryptionPrompts.decrypt` | ||
| # CSS `<style>` definitions targeting the `tc-password-wrapper` class to apply styles to the form | ||
|
|
||
| Raw markup tiddlers are spliced into the top of the standalone HTML file, and are executed before the boot prefix and boot kernel. | ||
|
|
||
| See $:/PathEncryptionPrompt for an example. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,33 @@ | ||
| title: $:/PatchEncryptionPrompt | ||
| tags: $:/core/wiki/rawmarkup | ||
|
|
||
| <script> | ||
|
|
||
| window.$tw = window.$tw || Object.create(null); | ||
| $tw.boot = $tw.boot || Object.create(null); | ||
|
|
||
| $tw.boot.encryptionPrompts = { | ||
| decrypt: "Decrypt this TiddlyWiki by entering the password" | ||
| }; | ||
|
|
||
| </script> | ||
| <style> | ||
|
|
||
| body .tc-password-wrapper { | ||
| background-color: rgb(183, 197, 235); | ||
| border: 8px solid rgb(152, 164, 197); | ||
| } | ||
|
|
||
| body .tc-password-wrapper form { | ||
| text-align: center; | ||
| } | ||
|
|
||
| body .tc-password-wrapper h1 { | ||
| padding-bottom: 8px; | ||
| } | ||
|
|
||
| body .tc-password-wrapper input { | ||
| width: auto; | ||
| } | ||
|
|
||
| </style> |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,10 @@ | ||
| created: 20131127215321439 | ||
| modified: 20140912135951542 | ||
| title: $:/DefaultTiddlers | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| [[TiddlyWiki Pre-release]] | ||
| [tag[ReleaseNotes]!has[released]] | ||
| HelloThere | ||
| GettingStarted | ||
| Community |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,3 @@ | ||
| title: $:/GoogleAnalyticsAccount | ||
|
|
||
| UA-32839735-1 |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,3 @@ | ||
| title: $:/GoogleAnalyticsDomain | ||
|
|
||
| tiddlywiki.com |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,3 @@ | ||
| title: $:/SiteSubtitle | ||
|
|
||
| <<version>> |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,6 @@ | ||
| created: 20131211131022562 | ||
| modified: 20131211131023829 | ||
| title: $:/SiteTitle | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| TiddlyWiki Pre-release |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,6 @@ | ||
| title: TiddlyWiki Pre-release | ||
| modified: 20141013204930183 | ||
|
|
||
| This is a pre-release build of TiddlyWiki. | ||
|
|
||
| It is provided for testing purposes. Please don't try to use it for anything important -- you should use the latest official release from http://tiddlywiki.com. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,34 @@ | ||
| { | ||
| "plugins": [ | ||
| "tiddlywiki/cecily", | ||
| "tiddlywiki/googleanalytics", | ||
| "tiddlywiki/nodewebkitsaver", | ||
| "tiddlywiki/github-fork-ribbon", | ||
| "tiddlywiki/browser-sniff" | ||
| ], | ||
| "themes": [ | ||
| "tiddlywiki/vanilla", | ||
| "tiddlywiki/snowwhite", | ||
| "tiddlywiki/nighttime", | ||
| "tiddlywiki/starlight", | ||
| "tiddlywiki/seamless", | ||
| "tiddlywiki/stickytitles", | ||
| "tiddlywiki/centralised", | ||
| "tiddlywiki/readonly" | ||
| ], | ||
| "languages": [ | ||
| "en-US", | ||
| "en-GB", | ||
| "de-AT", | ||
| "de-DE", | ||
| "fr-FR", | ||
| "zh-Hans", | ||
| "zh-Hant", | ||
| "it-IT", | ||
| "ja-JP", | ||
| "ru-RU" | ||
| ], | ||
| "includeWikis": [ | ||
| "../tw5.com" | ||
| ] | ||
| } |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,15 @@ | ||
| created: 20141020072708790 | ||
| modified: 20141020072708790 | ||
| tags: Resources | ||
| title: "TiddlyWiki5 Bourbon" by mkt_memory | ||
| type: text/vnd.tiddlywiki | ||
| url: http://bacchus.ivory.ne.jp/bourbon/ | ||
|
|
||
| An extensive collection of tips and resources for users of TiddlyWiki in Japanese. | ||
|
|
||
| <<< | ||
| TiddlyWikiをHTML5にしたTiddlyWiki5が正式にリリースされました。このTiddlyWiki5の使い方について、自分で試した機能を中心に解説します。 | ||
|
|
||
| TiddlyWiki5は、非常に多機能なローカルWikiです。このブログに書いてあることは、TiddlyWiki5で出来ることのごく一部です。 | ||
| <<< | ||
|
|
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,16 @@ | ||
| created: 20141009170239174 | ||
| modified: 20141009170711343 | ||
| tags: Resources | ||
| title: "TiddlyWiki5^2 documenting while learning TiddlyWiki5" by Iannis Zannos | ||
| type: text/vnd.tiddlywiki | ||
| url: http://larigot.avarts.ionio.gr/users/iani/wikis/tw5square.html | ||
|
|
||
| A wealth of hints, tips and notes about using [[TiddlyWiki on Node.js]]: | ||
|
|
||
| <<< | ||
| TiddlyWiki is different from other wikis because of its principle of dynamically customizeable "storyline" based on tiddlers as basic units of information. That is, the user "composes" their own version of the webpage by clicking on tiddler links, which add tiddlers to the page in order to compose a storyline. | ||
|
|
||
| The Node.js implementation in TiddlyWiki5 adds all the advantages of flat-file markup language based type of site. This makes TiddlyWiki an excellent alternative to flat-file based CMS/webpage/blog authoring systems for the web. | ||
|
|
||
| Also very cool is the treatment of tags as menus everywhere. | ||
| <<< |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,9 +1,9 @@ | ||
| created: 20130825144900000 | ||
| modified: 20141012154500719 | ||
| tags: Concepts | ||
| title: CurrentTiddler | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| The CurrentTiddler is the current tiddler during WikiText rendering. It is usually set by the TiddlerWidget. It allows you to write references like `<$view field="title"/>` in TemplateTiddlers without explicitly specifying the tiddler that it applies to. | ||
|
|
||
| The title of the current tiddler is contained in the [[WidgetVariable: currentTiddler]]. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,3 @@ | ||
| title: Caruso - Ave Maria | ||
| type: audio/mp3 | ||
| _canonical_uri: https://archive.org/download/Caruso_part1/Caruso-AveMaria.mp3 |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,2 @@ | ||
| title: TiddlyWiki.mp3 | ||
| type: audio/mp3 |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,15 @@ | ||
| created: 20140410103123179 | ||
| modified: 20140410103123179 | ||
| tags: Filters | ||
| caption: addprefix | ||
| title: FilterOperator: addprefix | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| The ''addprefix'' filter operator add a prefix to all titles in the current list. | ||
|
|
||
| For example: | ||
|
|
||
| |!Filter String |!Description | | ||
| |`one two three +[addprefix[tid-]]` |Returns `tid-one`, `tid-two`, `tid-three` | | ||
|
|
||
| See also [[FilterOperator: prefix]], [[FilterOperator: suffix]], [[FilterOperator: addsuffix]], [[FilterOperator: removeprefix]] and [[FilterOperator: removesuffix]]. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,15 @@ | ||
| created: 20140828133830424 | ||
| modified: 20140902145613329 | ||
| tags: Filters | ||
| caption: addsuffix | ||
| title: FilterOperator: addsuffix | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| The ''addsuffix'' filter operator adds a suffix to all titles in the current list. | ||
|
|
||
| For example: | ||
|
|
||
| |!Filter String |!Description | | ||
| |`one two three +[addsuffix[-tid]]` |Returns `one-tid`, `two-tid`, `three-tid` | | ||
|
|
||
| See also [[FilterOperator: suffix]], [[FilterOperator: prefix]], [[FilterOperator: addprefix]], [[FilterOperator: removesuffix]], and [[FilterOperator: removeprefix]]. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,14 +1,11 @@ | ||
| created: 20140410103123179 | ||
| modified: 20141007213204936 | ||
| tags: Concepts | ||
| title: FilterOperators | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| Filter operators are the individual elements of [[filters|Filters]]. See [[Introduction to Filters]] for details. | ||
|
|
||
| The full list of available filter operators is: | ||
|
|
||
| <<list-links "[tag[Filters]]">> |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,30 @@ | ||
| created: 20141001132300000 | ||
| modified: 20141001132300000 | ||
| tags: Learning | ||
| title: How to apply custom styles by tag | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| You can apply custom styles to tiddlers that have a particular tag by defining a CSS class with the name `tc-tagged-<Tag Name>`. | ||
|
|
||
| For example, to make tiddlers tagged "NightReader" appear in a special colour scheme suitable for night-time reading, [[create a stylesheet|Using Stylesheets]] defining the class `tc-tagged-NightReader` like this: | ||
|
|
||
| ``` | ||
| .tc-tagged-NightReader { | ||
| background-color:black; | ||
| color: orange; | ||
| padding: 35px 35px; | ||
| } | ||
|
|
||
| .tc-tagged-NightReader .tc-tiddler-body { | ||
| font-size: 1.5em; | ||
| } | ||
| ``` | ||
|
|
||
| The `tc-tagged-NightReader` class is applied to the entire tiddler and not just the tiddler text. If you want to target a smaller portion of the tiddler you can qualify the CSS selector, as is done here with `.tc-tagged-NightReader .tc-tiddler-body`. | ||
|
|
||
| Note that tags containing spaces or non-alphanumeric characters will be converted using URI encoding, making the generated CSS classname hard to predict. For example: | ||
|
|
||
| |!Tag |!Generated Class Name | | ||
| |`$:/mytag |`tc-tagged-%24%3A%2Fmytag` | | ||
| |`one two` |`tc-tagged-one%20two` | | ||
| |`£35.23` |`tc-tagged-%C2%A335.23` | |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,27 @@ | ||
| title: How to put the last modification date in a banner | ||
| created: 20141020111002211 | ||
| modified: 20141020111002211 | ||
| tags: Learning | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| Here's how to display the last modification date of a wiki in a banner in the corner of the window: | ||
|
|
||
| # Copy the plugin $:/plugins/tiddlywiki/github-fork-ribbon (labelled "GitHub-style ribbon in pure CSS") to your TiddlyWiki | ||
| # Save and reload your wiki | ||
| # Create a new tiddler called [[$:/_MyRibbon]] tagged [[$:/tags/PageControls]] and containing:<div> | ||
|
|
||
| ``` | ||
| <div class="github-fork-ribbon-wrapper right"> | ||
| <div class="github-fork-ribbon" style="background-color:#DF4848;"> | ||
| <$list filter="[!is[system]!has[draft.of]!sort[modified]limit[1]]"> | ||
| <$link> | ||
| <$view field="modified" format="date" template="DD mmm YYYY at 0hh:0mm"/> | ||
| </$link> | ||
| </$list> | ||
| </div> | ||
| </div> | ||
| ``` | ||
| </div> | ||
| # If required, change the background-color value to your preference | ||
| # You can also try changing the positioning class from `right` to `right-bottom` | ||
| ## To make the banner appear at the top left you'll need to tag the tiddler [[$:/tags/PageTemplate]] instead of [[$:/tags/PageControls]] and then change the position class to `left` |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,28 @@ | ||
| caption: now | ||
| created: 20141008141616791 | ||
| modified: 20141013180540337 | ||
| tags: Macros | ||
| title: NowMacro | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| The 'now' macro returns the current date and time, formatted with an optional format string. | ||
|
|
||
| ! Parameters | ||
|
|
||
| |!Position |!Name |!Description |!Default | | ||
| |1st |format |DateFormat string specifying the format for the date/time |`0hh:0mm, DDth MMM YYYY` | | ||
|
|
||
| ! Examples | ||
|
|
||
| For example: | ||
|
|
||
| ``` | ||
| * <<now>> | ||
| * <<now "DDth MMM YYYY">> | ||
| ``` | ||
|
|
||
| Returns: | ||
|
|
||
| * <<now>> | ||
| * <<now "DDth MMM YYYY">> | ||
|
|
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,9 +1,9 @@ | ||
| created: 20131109105400007 | ||
| modified: 20141010092837891 | ||
| tags: Releases | ||
| title: BetaReleases | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| Here are the details of the beta releases of TiddlyWiki5. See [[TiddlyWiki5 Versioning]] for details of how releases are named. | ||
|
|
||
| <<tabs "[tag[BetaReleaseNotes]!sort[created]]" "Release 5.0.18-beta" "$:/state/tab2" "tc-vertical" "ReleaseTemplate">> |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,68 @@ | ||
| caption: 5.1.3 | ||
| created: 20141020171015200 | ||
| modified: 20141020171015200 | ||
| tags: ReleaseNotes | ||
| title: Release 5.1.3 | ||
| type: text/vnd.tiddlywiki | ||
| released: 20141020171015200 | ||
|
|
||
| //[[See GitHub for detailed change history of this release|https://github.com/Jermolene/TiddlyWiki5/compare/v5.1.2...v5.1.3]]// | ||
|
|
||
| !! Usability Improvements | ||
|
|
||
| * [[Added|https://github.com/Jermolene/TiddlyWiki5/commit/e872f17842809e33eae177980e9ea0650b6a4c03]] "new journal" button; see [[Creating journal tiddlers]] | ||
| * [[Added|https://github.com/Jermolene/TiddlyWiki5/commit/70984aa39f8a4061162d4e404bfd158e515c7e6e]] "new here" button; see [[Creating and editing tiddlers]] | ||
| * [[Added|https://github.com/Jermolene/TiddlyWiki5/commit/00cdd04edd49c2bf0e461071c0c7c50f8aab4e42]] "new journal here" button; see [[Creating journal tiddlers]] | ||
| * [[Made|https://github.com/Jermolene/TiddlyWiki5/commit/c6951ee912d1f2717a8c208cbb920e54edf9e5d9]] date format strings be translateable | ||
| * [[Added|https://github.com/Jermolene/TiddlyWiki5/tree/master/languages/ru-RU]] Russian translation | ||
| * [[Added|https://github.com/Jermolene/TiddlyWiki5/commit/ef1d5310918dae088ce9361c1682ce0f99cf568a]] confirmation when clearing password | ||
| * [[Added|https://github.com/Jermolene/TiddlyWiki5/commit/b7bbcfa05659808c1e51a4f2f5f1d6afbc2ed3a1]] additional prompt when setting password | ||
| * [[Increased|https://github.com/Jermolene/TiddlyWiki5/commit/dc9981322aeb508d5ebac0b691b0d703f8c1995e]] size of the clear search button | ||
| * [[Upgraded|https://github.com/Jermolene/TiddlyWiki5/commit/564457de1c991df15263040d2d5526fa8ae879bb]] to [[KaTeX v0.1.1|https://github.com/Khan/KaTeX/releases/tag/v0.1.1]], with support for several additional LaTeX features | ||
|
|
||
|
|
||
| !! Hackability Improvements | ||
|
|
||
| * [[Added|https://github.com/Jermolene/TiddlyWiki5/commit/2ffe53f1916e4b746cc6d7e74e8f4ac75c72e38a]] audio "parser" for handling [[Audio]] content | ||
| * [[Added|https://github.com/Jermolene/TiddlyWiki5/commit/0dcf54c3b59ed04645928f0ec4ced647e5a0da7f]] support for ActionWidgets | ||
| * [[Added|https://github.com/Jermolene/TiddlyWiki5/commit/65504d5d41e45326ab1b1b6c0c21eea4c9772797]] new [[FilterOperator: addprefix]] and [[FilterOperator: addsuffix]] | ||
| * [[Added|https://github.com/Jermolene/TiddlyWiki5/commit/0c8e5380778303cdd3308bed4a15290214841f8b]] support for custom password prompts | ||
| * [[Extended|https://github.com/Jermolene/TiddlyWiki5/commit/c26bd4c5a872f56c47e9f5cfc3fada468c53ddde]] the ListMacro to display ''caption'' field if present | ||
| * [[Extended|https://github.com/Jermolene/TiddlyWiki5/commit/12e26009eef5e29140ba1a880ff033428d673630]] ImageWidget to allow percentage width and height to be specified | ||
|
|
||
| !! Bug Fixes | ||
|
|
||
| * [[Fixed|https://github.com/Jermolene/TiddlyWiki5/commit/cc576b052e2b05fd93fcb4f3eb8d9ee5278abf3e]] [[FilterOperator: each]] to work with missing tiddlers | ||
| * [[Fixed|https://github.com/Jermolene/TiddlyWiki5/commit/5dd6ebff05a3380db2901294b2cfc89c1a0e71bf]] problem with tiddler width in zoomin storyview with the sidebar hidden | ||
| * [[Fixed|https://github.com/Jermolene/TiddlyWiki5/commit/09b6540998fec6bf1fb14842be8e8c53dbd5c46a]] bug whereby the `tm-home` message wasn't navigating to a tiddler, causing problems in zoomin storyview | ||
| * [[Fixed|https://github.com/Jermolene/TiddlyWiki5/commit/3ca8d7b6cca46ffa424bcf9bdc134da464fc84f4]] problem with jumping toolbar icons under Firefox | ||
| * [[Fixed|https://github.com/Jermolene/TiddlyWiki5/commit/f85b07e70b71d0622a9459e4b04e2027540abda8]] problem with untagged label being incorrectly coloured | ||
| * [[Fixed|https://github.com/Jermolene/TiddlyWiki5/commit/b3dcd7d625ec83701ef3a77f3fb8101af57c154f]] problem with title background colours with the "Sticky Titles" theme | ||
| * [[Fixed|https://github.com/Jermolene/TiddlyWiki5/commit/5211f9c40c874a167174e8c0d439db34189d3329]] problem with subfilter parameter of TimelineMacro | ||
| * [[Exclude|https://groups.google.com/d/topic/tiddlywiki/YPACpXhH9PY/discussion]] search string tiddler from search results | ||
|
|
||
| !! Node.js Changes | ||
|
|
||
| //These changes are only relevant to people using TiddlyWiki under Node.js// | ||
|
|
||
| * [[Extended|https://github.com/Jermolene/TiddlyWiki5/commit/63c174d7ed56284e80ad6cd6ae966b81f9181cc9]] ~KaTeX plugin to be able to work under Node.js to generate static HTML | ||
| * [[Extended|https://github.com/Jermolene/TiddlyWiki5/commit/49dc5694a391a391264a4473e4f4422e2472a3b3]] "includeWikis" to merge build targets | ||
| * [[Refactored|https://github.com/Jermolene/TiddlyWiki5/issues/969]] the build scripts for tiddlywiki.com into a separate repository at https://github.com/Jermolene/build.jermolene.github.io | ||
| * [[Extended|https://github.com/Jermolene/TiddlyWiki5/commit/744245ea3249446fd15f504190efb1d828935d01]] boot kernel to raise an error if a missing wiki folder is specified on the command line | ||
|
|
||
| !! Contributors | ||
|
|
||
| [[@Jermolene|https://github.com/Jermolene]] would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki: | ||
|
|
||
| * [[@andrey013|https://github.com/andrey013]] | ||
| * [[@BramChen|https://github.com/BramChen]] | ||
| * [[@buggyj|https://github.com/buggyj]] | ||
| * [[@Eucaly|https://github.com/Eucaly]] | ||
| * [[@Evolena|https://github.com/Evolena]] | ||
| * [[@fghhfg|https://github.com/fghhfg]] | ||
| * [[@Marxsal|https://github.com/Marxsal]] | ||
| * [[@pmario|https://github.com/pmario]] | ||
| * [[@simonbaird|https://github.com/simonbaird]] | ||
| * [[@TheDiveO|https://github.com/TheDiveO]] | ||
| * [[@xcazin|https://github.com/xcazin]] | ||
|
|
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,15 @@ | ||
| created: 20141002133113496 | ||
| modified: 20141002230631361 | ||
| tags: Reference | ||
| title: Variables | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| Variables together with [[Widgets]] and [[Macros]] are essential for dynamic WikiText. | ||
|
|
||
| You can define your own [[Variables in WikiText]] or use built-in variables. | ||
|
|
||
| More detailed information of built-in variables could be found in below: | ||
|
|
||
| <<list-links "[tag[Variables]]">> | ||
|
|
||
| See also DumpVariablesMacro |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,22 @@ | ||
| caption: currentTiddler | ||
| created: 20141001232824187 | ||
| modified: 20141002161518301 | ||
| tags: Variables | ||
| title: WidgetVariable: currentTiddler | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| ! Mechanism | ||
|
|
||
| The ''currentTiddler'' variable contains the title of the current tiddler. | ||
|
|
||
| The ListWidget assigns the list result to the ''currentTiddler'' variable, unless the `variable` attribute is specified. | ||
|
|
||
| A couple of [[Widgets]] and [[Macros]] by default apply to the tiddler according to the ''currentTiddler'' variable. | ||
|
|
||
| The TranscludeWidget (or WikiText `{{||TemplateTitle}}`) transcludes a tiddler without changing the ''currentTiddler'' variable. | ||
|
|
||
| ! Using currentTiddler Variable | ||
|
|
||
| These mechanisms together allow you to write references like `<$view field="title" format="link"/>` in TemplateTiddlers or inside the ListWidget hierarchy without explicitly specifying the tiddler that it applies to. | ||
|
|
||
| See also [[WidgetVariable: storyTiddler]] and [[WidgetVariable: currentTiddler]] |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,10 @@ | ||
| caption: storyTiddler | ||
| created: 20141001232753952 | ||
| modified: 20141002133957245 | ||
| tags: Variables | ||
| title: WidgetVariable: storyTiddler | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| The ''storyTiddler'' variable is set by the [[default viewtemplate|$:/core/ui/ViewTemplate]] to the name of the current tiddler within tiddlers in the story river, and is not defined within the sidebar. | ||
|
|
||
| See also [[WidgetVariable: currentTiddler]] |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,36 @@ | ||
| caption: transclusion | ||
| created: 20141002004621385 | ||
| modified: 20141002162057822 | ||
| tags: Variables | ||
| title: WidgetVariable: transclusion | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| ! Mechanism | ||
| The ''transclusion'' variable is set automatically by the transclude widget to contain a string that identifies the position of the current node within the widget tree. In the sidebar it is set to `{|$:/core/ui/PageTemplate/sidebar|||}` and within the tiddler "HelloThere" in the story river it is set to `{HelloThere|HelloThere|||}`. Each nested level of transclusion appends another curly bracketed list of symbols. | ||
|
|
||
| The QualifyMacro uses the ''transclusion'' variable to identify the stack of transcluded tiddlers. | ||
|
|
||
| ! Example | ||
|
|
||
| ``` | ||
| \define mymacro() | ||
| Hello from mymacro | ||
| <$list filter="[<transclusion>prefix[{|$:/core/ui/PageTemplate/sidebar|||}]]" emptyMessage="in a tiddler"> | ||
| in the sidebar | ||
| </$list> | ||
| \end | ||
|
|
||
| <<mymacro>> | ||
| ``` | ||
|
|
||
| Result in story tiddler | ||
|
|
||
| ``` | ||
| Hello from mymacro in a tiddler | ||
| ``` | ||
|
|
||
| Result in the sidebar | ||
|
|
||
| ``` | ||
| Hello from mymacro in the sidebar | ||
| ``` |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,38 @@ | ||
| caption: action-navigate | ||
| created: 20141008163514491 | ||
| modified: 20141008164303144 | ||
| tags: Widgets ActionWidgets | ||
| title: ActionNavigateWidget | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| ! Introduction | ||
|
|
||
| The ''action-navigate'' widget is an [[action widget|ActionWidgets]] that sends a [[tm-navigate|WidgetMessage: tm-navigate]] message back up the widget tree. ActionWidgets are used within triggering widgets such as the ButtonWidget. | ||
|
|
||
| ! Content and Attributes | ||
|
|
||
| The ''action-navigate'' widget is invisible. Any content within it is ignored. | ||
|
|
||
| |!Attribute |!Description | | ||
| |$to |The title of the target tiddler for the navigation (if not provided defaults to the [[WidgetVariable: currentTiddler]] | | ||
| |$scroll |Optional parameter determining whether the navigation will also cause a scroll to the target tiddler (see below) | | ||
|
|
||
| !! Scroll handling | ||
|
|
||
| The optional `$scroll` attribute can be set to "yes" to force scrolling to occur to bring the target tiddler into view. If set to "no" then scrolling does not occur. If the `$scroll` attribute is omitted then scrolling occurs unless either: | ||
|
|
||
| * the control key is pressed | ||
| * the action was initiated with the middle mouse button (if available) | ||
|
|
||
| Note that if navigating to multiple tiddlers at once you should use the same `$scroll` setting for all of them. | ||
|
|
||
| ! Examples | ||
|
|
||
| Here is an example of button that navigates to two different tiddlers at once: | ||
|
|
||
| <$macrocall $name='wikitext-example-without-html' | ||
| src='<$button> | ||
| <$action-navigate $to="ButtonWidget"/> | ||
| <$action-navigate $to="ActionWidgets"/> | ||
| Click me! | ||
| </$button>'/> |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,31 @@ | ||
| caption: action-sendmessage | ||
| created: 20141008134309742 | ||
| modified: 20141008162952455 | ||
| tags: Widgets ActionWidgets | ||
| title: ActionSendMessageWidget | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| ! Introduction | ||
|
|
||
| The ''action-sendmessage'' widget is an [[action widget|ActionWidgets]] that sends a [[message|WidgetMessages]] back up the widget tree. ActionWidgets are used within triggering widgets such as the ButtonWidget. | ||
|
|
||
| ! Content and Attributes | ||
|
|
||
| The ''action-sendmessage'' widget is invisible. Any content within it is ignored. | ||
|
|
||
| |!Attribute |!Description | | ||
| |$message |The message to send (eg, [[WidgetMessage: tm-new-tiddler]]) | | ||
| |$param |Optional parameter string whose meaning is dependent on the message being sent | | ||
| |//{any attributes not starting with $}// |Multiple parameters that are attached to the message if the `$param$` attribute is not provided | | ||
|
|
||
| ! Examples | ||
|
|
||
| Here is an example of button that displays both a notification and a wizard, and creates a new tiddler with tags and text: | ||
|
|
||
| <$macrocall $name='wikitext-example-without-html' | ||
| src='<$button> | ||
| <$action-sendmessage $message="tm-modal" $param="SampleWizard"/> | ||
| <$action-sendmessage $message="tm-notify" $param="SampleNotification"/> | ||
| <$action-sendmessage $message="tm-new-tiddler" title="This is newly created tiddler" tags="OneTag [[Another Tag]]" text=<<now "Today is DDth, MMM YYYY">>/> | ||
| Click me! | ||
| </$button>'/> |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,23 @@ | ||
| created: 20141008134425548 | ||
| modified: 20141008144957192 | ||
| tags: Widgets | ||
| title: ActionWidgets | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| Action widgets are a special type of widget that perform an action such as sending a message, navigating to a tiddler, or changing the value of a tiddler. They are used in association with other widgets that trigger those actions (for example, the ButtonWidget). | ||
|
|
||
| Action widgets are invisible. They must be the immediate children of their parent triggering widget. The actions are performed in sequence. For example, here is a button that triggers two actions of sending different messages: | ||
|
|
||
| ``` | ||
| <$button> | ||
| <$action-sendmessage $message="tm-home"/> | ||
| <$action-sendmessage $message="tm-full-screen"/> | ||
| Click me! | ||
| </$button> | ||
| ``` | ||
|
|
||
| Take care not to accidentally introduce an extra line break after the opening tag of the button widget. Doing so will trigger the WikiText parser to wrap the action widgets in a paragraph element. This means that the action widgets will not be triggered as they are no longer immediate children of the triggering widget. | ||
|
|
||
| The following action widgets are provided: | ||
|
|
||
| <<list-links "[tag[ActionWidgets]]">> |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,60 @@ | ||
| caption: Confusion between Transclusion and Substitution | ||
| created: 20141018090608643 | ||
| modified: 20141018181414011 | ||
| tags: WikiText | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| The power of WikiText comes from the ability to use the content of one tiddler inside another one. This ability takes several different forms that can easily be confused. | ||
|
|
||
| The main distinction is between a transclusion and a textual substitution: | ||
|
|
||
| * A transclusion is replaced dynamically with the value of either: | ||
| ** a tiddler field | ||
| ** a variable | ||
| * Textual substitutions are performed on the text of macro definitions before they are used | ||
|
|
||
| ! Tiddler Field Transclusion | ||
|
|
||
| [[Transclusion in WikiText]] describes the basics of transclusion. For example: | ||
|
|
||
| ``` | ||
| {{MyTiddler}} | ||
| ``` | ||
|
|
||
| As described in [[HTML in WikiText]], you can also transclude tiddler field values as attributes of HTML elements and widgets. For example: | ||
|
|
||
| ``` | ||
| <$text text={{MyTiddler}}/> | ||
| ``` | ||
|
|
||
| As described in [[Introduction to Filters]], you can also transclude tiddler field values as filter operands. For example: | ||
|
|
||
| ``` | ||
| {{{ [tag{TiddlerContainingMyTag}] }}} | ||
| ``` | ||
|
|
||
| ! Variable/Macro Transclusion | ||
|
|
||
| Variables that were defined with parameter or variable substitution are referred to as "macros". The value of a variable/macro can be transcluded with the syntax: | ||
|
|
||
| ``` | ||
| <<myMacro param:"Value of parameter">> | ||
| ``` | ||
|
|
||
| As described in [[HTML in WikiText]], you can also transclude a variable as the value of an attribute of HTML elements and widgets. For example: | ||
|
|
||
| ``` | ||
| <$text text=<<myMacro>>/> | ||
| ``` | ||
|
|
||
| As described in [[Introduction to Filters]], you can also transclude a variable as the value of a filter operand. For example: | ||
|
|
||
| ``` | ||
| {{{ [tag<myMacro>] }}} | ||
| ``` | ||
|
|
||
| ! Textual Substitution | ||
|
|
||
| Textual substitution occurs when the value of a macro/variable is used. It is described in [[Macros in WikiText]]. | ||
|
|
||
| The key difference between substitution and transclusion is that substitution occurs before WikiText parsing. This means that you can use substitution to build WikiText constructions. Transclusions are processed independently, and cannot be combined with adjacent text to define WikiText constructions. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,28 @@ | ||
| caption: Variables | ||
| created: 20141002141231992 | ||
| modified: 20141018104313995 | ||
| tags: WikiText | ||
| title: Variables in WikiText | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| ! Defining Variables | ||
| Variables contains values defined by [[Widgets]]. | ||
| Variables are available within the widget that defines them, and the child widgets in the widget tree. | ||
|
|
||
| Variables are defined by: | ||
|
|
||
| * TiddlyWiki core and viewtemplate | ||
| * SetWidget | ||
| * ListWidget | ||
| * [[Macro definition|Macros in WikiText]] | ||
|
|
||
| ! Using Variables | ||
|
|
||
| Variables are used in: | ||
|
|
||
| * Variable substitution `$(name)$` | ||
| * Concise shortcut `<<name>>` | ||
| * [[Filter expression|Introduction to Filters]] `[operator<variable-operand>]` | ||
| * Some default behaviors of [[Widgets]] | ||
|
|
||
| See also [[currentTiddler|WidgetVariable: currentTiddler]] variable, built-in [[variables|Variables]] and [[Confusion between Transclusion and Substitution]]. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,25 @@ | ||
| created: 20141018131647392 | ||
| modified: 20141019200654436 | ||
| tags: [[Working with TiddlyWiki]] | ||
| title: Audio | ||
| type: text/vnd.tiddlywiki | ||
|
|
||
| Audio files can be incorporated into TiddlyWiki in a very similar way to [[images|Images]]. | ||
|
|
||
| ! Embedded Audio | ||
|
|
||
| Small audio files can be embedded directly within TiddlyWiki. Embedding isn't suitable for large files (over a few hundred kilobytes) because it increases the size of the TiddlyWiki file. | ||
|
|
||
| For example, the tiddler [[TiddlyWiki.mp3]] contains an MP3 recording of the word "TiddlyWiki". Viewing the tiddler directly should show an audio player that allows playback. | ||
|
|
||
| You can also transclude audio files. For example: | ||
|
|
||
| <<wikitext-example-without-html '{{TiddlyWiki.mp3}}'>> | ||
|
|
||
| ! External Audio | ||
|
|
||
| External audio tiddlers use the ''_canonical_uri'' field to point to an external audio file/stream, and have a block ''text'' field. This reduces their size considerably, and still allows for playback. | ||
|
|
||
| For example, the tiddler [[Caruso - Ave Maria]] points to an online audio recording hosted on http://archive.org: | ||
|
|
||
| <<wikitext-example-without-html '{{Caruso - Ave Maria}}'>> |