kopia lustrzana https://github.com/miklobit/TiddlyWiki5
Move command documentation into the core
rodzic
cadeb9654c
commit
e5103c32f3
|
@ -0,0 +1,22 @@
|
|||
title: $:/language/Help/default
|
||||
|
||||
\define commandTitle()
|
||||
$:/language/Help/$(command)$
|
||||
\end
|
||||
```
|
||||
usage: tiddlywiki [<wikifolder>] [--<command> [<args>...]...]
|
||||
```
|
||||
|
||||
Available commands:
|
||||
|
||||
<ul>
|
||||
<$list filter="[commands[]sort[title]]" variable="command">
|
||||
<li><$link to=<<commandTitle>>><$macrocall $name="command" $type="text/plain" $output="text/plain"/></$link>: <$transclude tiddler=<<commandTitle>> field="description"/></li>
|
||||
</$list>
|
||||
</ul>
|
||||
|
||||
To get detailed help on a command:
|
||||
|
||||
```
|
||||
tiddlywiki --help <command>
|
||||
```
|
|
@ -0,0 +1,10 @@
|
|||
title: $:/language/Help/help
|
||||
description: Display help for TiddlyWiki commands
|
||||
|
||||
Displays help text for a command:
|
||||
|
||||
```
|
||||
--help [<command>]
|
||||
```
|
||||
|
||||
If the command name is omitted then a list of available commands is displayed.
|
|
@ -0,0 +1,23 @@
|
|||
title: $:/language/Help/init
|
||||
description: Initialise a new wiki folder
|
||||
|
||||
Initialise an empty [[WikiFolder|WikiFolders]] with a copy of the specified edition.
|
||||
|
||||
```
|
||||
--init <edition> [<edition> ...]
|
||||
```
|
||||
|
||||
For example:
|
||||
|
||||
```
|
||||
tiddlywiki ./MyWikiFolder --init empty
|
||||
```
|
||||
|
||||
Note:
|
||||
|
||||
* The wiki folder directory will be created if necessary
|
||||
* The "edition" defaults to ''empty''
|
||||
* The init command will fail if the wiki folder is not empty
|
||||
* The init command removes any `includeWikis` definitions in the edition's `tiddlywiki.info` file
|
||||
* When multiple editions are specified, editions initialised later will overwrite any files shared with earlier editions (so, the final `tiddlywiki.info` file will be copied from the last edition)
|
||||
* `--help editions` returns a list of available editions
|
|
@ -0,0 +1,14 @@
|
|||
title: $:/language/Help/load
|
||||
description: Load tiddlers from a file
|
||||
|
||||
Load tiddlers from 2.x.x TiddlyWiki files (`.html`), `.tiddler`, `.tid`, `.json` or other files
|
||||
|
||||
```
|
||||
--load <filepath>
|
||||
```
|
||||
|
||||
To load tiddlers from an encrypted TiddlyWiki file you should first specify the password with the PasswordCommand. For example:
|
||||
|
||||
```
|
||||
tiddlywiki ./MyWiki --password pa55w0rd --load my_encrypted_wiki.html
|
||||
```
|
|
@ -0,0 +1,3 @@
|
|||
title: $:/language/Help/notfound
|
||||
|
||||
No such help item
|
|
@ -0,0 +1,9 @@
|
|||
title: $:/language/Help/password
|
||||
description: Set a password for subsequent crypto operations
|
||||
|
||||
Set a password for subsequent crypto operations
|
||||
|
||||
```
|
||||
--password <password>
|
||||
```
|
||||
|
|
@ -0,0 +1,8 @@
|
|||
title: $:/language/Help/rendertiddler
|
||||
description: Render an individual tiddler as a specified ContentType
|
||||
|
||||
Render an individual tiddler as a specified ContentType, defaults to `text/html` and save it to the specified filename:
|
||||
|
||||
```
|
||||
--rendertiddler <title> <filename> [<type>]
|
||||
```
|
|
@ -0,0 +1,14 @@
|
|||
title: $:/language/Help/rendertiddlers
|
||||
description: Render tiddlers matching a filter to a specified ContentType
|
||||
|
||||
Render a set of tiddlers matching a filter to separate files of a specified ContentType (defaults to `text/html`) and extension (defaults to `.html`).
|
||||
|
||||
```
|
||||
--rendertiddlers <filter> <template> <pathname> [<type>] [<extension>]
|
||||
```
|
||||
|
||||
For example:
|
||||
|
||||
```
|
||||
--rendertiddlers [!is[system]] $:/core/templates/static.tiddler.html ./static text/plain
|
||||
```
|
|
@ -0,0 +1,8 @@
|
|||
title: $:/language/Help/savetiddler
|
||||
description: Saves a raw tiddler to a file
|
||||
|
||||
Saves an individual tiddler in its raw text or binary format to the specified filename.
|
||||
|
||||
```
|
||||
--savetiddler <title> <filename>
|
||||
```
|
|
@ -0,0 +1,30 @@
|
|||
title: $:/language/Help/server
|
||||
description: Provides an HTTP server interface to TiddlyWiki
|
||||
|
||||
The server built in to TiddlyWiki5 is very simple. Although compatible with TiddlyWeb it doesn't support many of the features needed for robust Internet-facing usage.
|
||||
|
||||
At the root, it serves a rendering of a specified tiddler. Away from the root, it serves individual tiddlers encoded in JSON, and supports the basic HTTP operations for `GET`, `PUT` and `DELETE`.
|
||||
|
||||
```
|
||||
--server <port> <roottiddler> <rendertype> <servetype> <username> <password> <host>
|
||||
```
|
||||
|
||||
The parameters are:
|
||||
|
||||
* ''port'' - port number to serve from (defaults to "8080")
|
||||
* ''roottiddler'' - the tiddler to serve at the root (defaults to "$:/core/save/all")
|
||||
* ''rendertype'' - the content type to which the root tiddler should be rendered (defaults to "text/plain")
|
||||
* ''servetype'' - the content type with which the root tiddler should be served (defaults to "text/html")
|
||||
* ''username'' - the default username for signing edits
|
||||
* ''password'' - optional password for basic authentication
|
||||
* ''host'' - optional hostname to serve from (defaults to "127.0.0.1" aka "localhost")
|
||||
|
||||
If the password parameter is specified then the browser will prompt the user for the username and password. Note that the password is transmitted in plain text so this implementation isn't suitable for general use.
|
||||
|
||||
For example:
|
||||
|
||||
```
|
||||
--server 8080 $:/core/save/all text/plain text/html MyUserName passw0rd
|
||||
```
|
||||
|
||||
To run multiple TiddlyWiki servers at the same time you'll need to put each one on a different port.
|
|
@ -0,0 +1,8 @@
|
|||
title: $:/language/Help/verbose
|
||||
description: Triggers verbose output mode
|
||||
|
||||
Triggers verbose output, useful for debugging
|
||||
|
||||
```
|
||||
--verbose
|
||||
```
|
|
@ -0,0 +1,8 @@
|
|||
title: $:/language/Help/version
|
||||
description: Displays the version number of TiddlyWiki
|
||||
|
||||
Displays the version number of TiddlyWiki.
|
||||
|
||||
```
|
||||
--version
|
||||
```
|
|
@ -0,0 +1,7 @@
|
|||
created: 20140225195548209
|
||||
modified: 20140225195738745
|
||||
tags: command
|
||||
title: HelpCommand
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
{{$:/language/Help/help}}
|
|
@ -4,23 +4,4 @@ tags: command
|
|||
title: InitCommand
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
Initialise an empty [[WikiFolder|WikiFolders]] with a copy of the specified edition.
|
||||
|
||||
```
|
||||
--init <edition> [<edition> ...]
|
||||
```
|
||||
|
||||
For example:
|
||||
|
||||
```
|
||||
tiddlywiki ./MyWikiFolder --init empty
|
||||
```
|
||||
|
||||
Note:
|
||||
|
||||
* The edition directory will be created if necessary
|
||||
* The "edition" defaults to ''empty''
|
||||
* The init command will fail if the wiki folder does not exist, or is not empty
|
||||
* The init command removes any `includeWikis` definitions in the edition's `tiddlywiki.info` file
|
||||
* When multiple editions are specified, editions initialised later will overwrite any files shared with earlier editions (so, the final `tiddlywiki.info` file will be copied from the last edition)
|
||||
|
||||
{{$:/language/Help/init}}
|
||||
|
|
|
@ -4,14 +4,4 @@ tags: command
|
|||
title: LoadCommand
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
Load tiddlers from 2.x.x TiddlyWiki files (`.html`), `.tiddler`, `.tid`, `.json` or other files
|
||||
|
||||
```
|
||||
--load <filepath>
|
||||
```
|
||||
|
||||
To load tiddlers from an encrypted TiddlyWiki file you should first specify the password with the PasswordCommand. For example:
|
||||
|
||||
```
|
||||
tiddlywiki ./MyWiki --password pa55w0rd --load my_encrypted_wiki.html
|
||||
```
|
||||
{{$:/language/Help/load}}
|
||||
|
|
|
@ -1,9 +1,4 @@
|
|||
title: PasswordCommand
|
||||
tags: command
|
||||
|
||||
Set a password for subsequent crypto operations
|
||||
|
||||
```
|
||||
--password <password>
|
||||
```
|
||||
|
||||
{{$:/language/Help/password}}
|
||||
|
|
|
@ -1,8 +1,4 @@
|
|||
title: RenderTiddlerCommand
|
||||
tags: command
|
||||
|
||||
Render an individual tiddler as a specified ContentType, defaults to `text/html` and save it to the specified filename
|
||||
|
||||
```
|
||||
--rendertiddler <title> <filename> [<type>]
|
||||
```
|
||||
{{$:/language/Help/rendertiddler}}
|
||||
|
|
|
@ -1,14 +1,4 @@
|
|||
title: RenderTiddlersCommand
|
||||
tags: command
|
||||
|
||||
Render a set of tiddlers matching a filter to separate files of a specified ContentType (defaults to `text/html`) and extension (defaults to `.html`).
|
||||
|
||||
```
|
||||
--rendertiddlers <filter> <template> <pathname> [<type>] [<extension>]
|
||||
```
|
||||
|
||||
For example:
|
||||
|
||||
```
|
||||
--rendertiddlers [!is[system]] $:/core/templates/static.tiddler.html ./static text/plain
|
||||
```
|
||||
{{{$:/language/Help/rendertiddlers}}}
|
||||
|
|
|
@ -3,8 +3,4 @@ tags: command
|
|||
created: 20131218121606089
|
||||
modified: 20131218121606089
|
||||
|
||||
Saves an individual tiddler in its raw text or binary format to the specified filename.
|
||||
|
||||
```
|
||||
--savetiddler <title> <filename>
|
||||
```
|
||||
{{$:/language/Help/savetiddler}}
|
||||
|
|
|
@ -4,30 +4,4 @@ tags: command
|
|||
title: ServerCommand
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
The server built in to TiddlyWiki5 is very simple. Although compatible with TiddlyWeb it doesn't support many of the features needed for robust Internet-facing usage.
|
||||
|
||||
At the root, it serves a rendering of a specified tiddler. Away from the root, it serves individual tiddlers encoded in JSON, and supports the basic HTTP operations for `GET`, `PUT` and `DELETE`.
|
||||
|
||||
```
|
||||
--server <port> <roottiddler> <rendertype> <servetype> <username> <password> <host>
|
||||
```
|
||||
|
||||
The parameters are:
|
||||
|
||||
* ''port'' - port number to serve from (defaults to "8080")
|
||||
* ''roottiddler'' - the tiddler to serve at the root (defaults to "$:/core/save/all")
|
||||
* ''rendertype'' - the content type to which the root tiddler should be rendered (defaults to "text/plain")
|
||||
* ''servetype'' - the content type with which the root tiddler should be served (defaults to "text/html")
|
||||
* ''username'' - the default username for signing edits
|
||||
* ''password'' - optional password for basic authentication
|
||||
* ''host'' - optional hostname to serve from (defaults to "127.0.0.1" aka "localhost")
|
||||
|
||||
If the password parameter is specified then the browser will prompt the user for the username and password. Note that the password is transmitted in plain text so this implementation isn't suitable for general use.
|
||||
|
||||
For example:
|
||||
|
||||
```
|
||||
--server 8080 $:/core/save/all text/plain text/html MyUserName passw0rd
|
||||
```
|
||||
|
||||
To run multiple TiddlyWiki servers at the same time you'll need to put each one on a different port.
|
||||
{{$:/language/Help/server}}
|
||||
|
|
|
@ -1,8 +1,4 @@
|
|||
title: VerboseCommand
|
||||
tags: command
|
||||
|
||||
Triggers verbose output, useful for debugging
|
||||
|
||||
```
|
||||
--verbose
|
||||
```
|
||||
{{$:/language/Help/verbose}}
|
||||
|
|
|
@ -1,8 +1,4 @@
|
|||
title: VersionCommand
|
||||
tags: command
|
||||
|
||||
Displays the version number of TiddlyWiki.
|
||||
|
||||
```
|
||||
--version
|
||||
```
|
||||
{{$:/language/Help/version}}
|
||||
|
|
Ładowanie…
Reference in New Issue