aboutsummaryrefslogtreecommitdiffhomepage
path: root/data/doc/sisu/v1/sisu_markup_samples/sisu_manual/sisu_help.sst
blob: 77bab0ad0da0483a097672561bbc7af6b79635d6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
% SiSU 0.58

@title: SiSU

@subtitle: Help

@creator: Amissah, Ralph

@rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3

@type: information

@subject: ebook, epublishing, electronic book, electronic publishing, electronic document, electronic citation, data structure, citation systems, search

@date.created: 2002-08-28

@date.issued: 2002-08-28

@date.available: 2002-08-28

@date.modified: 2007-08-30

@date: 2007-08-30

@level: new=C; break=1; num_top=1

@skin: skin_sisu_manual

@bold: /Gnu|Debian|Ruby|SiSU/

@links: { SiSU Manual }http://www.jus.uio.no/sisu/sisu_manual/
{ Book Samples and Markup Examples }http://www.jus.uio.no/sisu/SiSU/examples.html
{ SiSU @ Wikipedia }http://en.wikipedia.org/wiki/SiSU
{ SiSU @ Freshmeat }http://freshmeat.net/projects/sisu/
{ SiSU @ Ruby Application Archive }http://raa.ruby-lang.org/project/sisu/
{ SiSU @ Debian }http://packages.qa.debian.org/s/sisu.html
{ SiSU Download }http://www.jus.uio.no/sisu/SiSU/download.html
{ SiSU Changelog }http://www.jus.uio.no/sisu/SiSU/changelog.html
{ SiSU help }http://www.jus.uio.no/sisu/sisu_manual/sisu_help/
{ SiSU help sources }http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/

:A~? @title @creator

:B~? SiSU Help

1~help Help

2~ SiSU Manual

The most up to date information on sisu should be contained in the sisu_manual, available at:

_1 http://sisudoc.org/sisu/sisu_manual/

The manual can be generated from source, found respectively, either within the SiSU tarball
or installed locally at:

_1 ./data/doc/sisu/sisu_markup_samples/sisu_manual/

_1 /usr/share/doc/sisu/sisu_markup_samples/sisu_manual/

move to the respective directory and type e.g.:

_1 sisu sisu_manual.ssm

% The manual pages provided with SiSU are also available online, and there is an interactive help, which is being superseded by the man page, and possibly some document which contains this component.

2~ SiSU man pages *~man

If SiSU is installed on your system usual man commands should be available, try:

_1 man sisu

_1 man sisu_markup

_1 man sisu_commands

Most SiSU man pages are generated directly from sisu documents that are used to prepare the sisu manual, the sources files for which are located within the SiSU tarball at:

_1 ./data/doc/sisu/sisu_manual/

Once installed, directory equivalent to:

_1 /usr/share/doc/sisu/sisu_manual/

Available man pages are converted back to html using man2html:

_1 /usr/share/doc/sisu/html/

_1 ./data/doc/sisu/html/

An online version of the sisu man page is available here:

_* {~^ various sisu man pages }http://www.jus.uio.no/sisu/man/

_* {~^ sisu.1 }http://www.jus.uio.no/sisu/man/sisu.1.html

2~ SiSU built-in interactive help

This is particularly useful for getting the current sisu setup/environment information:

_1 sisu --help

_1 sisu --help [subject]

_2 sisu --help commands

_2 sisu --help markup

_2 sisu --help env [for feedback on the way your system is setup with regard to sisu]

_1 sisu -V [environment information, same as above command]

_1 sisu (on its own provides version and some help information)

Apart from real-time information on your current configuration the SiSU manual and man pages are likely to contain more up-to-date information than the sisu interactive help (for example on commands and markup).

NOTE: Running the command sisu (alone without any flags, filenames or wildcards) brings up the interactive help, as does any sisu command that is not recognised. Enter to escape.

2~ Help Sources

For lists of alternative help sources, see:

!_ man page

_1 man sisu_help_sources

!_ man2html

_1 /usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html

!_ sisu generated html

_1 /usr/share/doc/sisu/html/sisu_help_sources/index.html

_1 http://sisudoc.org/sisu/sisu_help_sources/index.html