diff options
Diffstat (limited to 'man/man1')
| -rw-r--r-- | man/man1/sisu_commands.1 | 575 | ||||
| -rw-r--r-- | man/man1/sisu_configuration.1 | 368 | ||||
| -rw-r--r-- | man/man1/sisu_help.1 | 318 | ||||
| -rw-r--r-- | man/man1/sisu_help_sources.1 | 729 | ||||
| -rw-r--r-- | man/man1/sisu_markup.1 | 1532 | ||||
| -rw-r--r-- | man/man1/sisu_skin.1 | 222 |
6 files changed, 0 insertions, 3744 deletions
diff --git a/man/man1/sisu_commands.1 b/man/man1/sisu_commands.1 deleted file mode 100644 index ca60efc6..00000000 --- a/man/man1/sisu_commands.1 +++ /dev/null @@ -1,575 +0,0 @@ -.TH "sisu_commands" "1" "2007-09-16" "0.59.1" "SiSU" -.SH -SISU \- COMMANDS, -RALPH AMISSAH -.BR - -.SH -SISU COMMANDS -.BR - -.SH -1. COMMANDS SUMMARY -.BR - -.SH -1.1 SYNOPSIS - -.BR -.B SiSU -\- Structured information, Serialized Units \- a document publishing system - -.BR -sisu \ [ \ \-abcDdFHhIiMmNnopqRrSsTtUuVvwXxYyZz0\-9 \ ] \ [ \ filename/ \ -wildcard \ ] - -.BR -sisu \ [ \ \-Ddcv \ ] \ [ \ instruction \ ] - -.BR -sisu \ [ \ \-CcFLSVvW \ ] - -.BR -Note: commands should be issued from within the directory that contains the -marked up files, cd to markup directory. - -.SH -1.2 DESCRIPTION - -.BR -.B SiSU -.B SiSU -is a document publishing system, that from a simple single marked\-up -document, produces multiple of output formats including: plaintext, html, -LaTeX, pdf, xhtml, XML, info, and SQL (PostgreSQL and SQLite), which share -numbered text objects (\"object citation numbering\") and the same document -structure information. For more see: <http://www.jus.uio.no/sisu> - -.SH -1.3 DOCUMENT PROCESSING COMMAND FLAGS - -.TP -.B \ \-a \ \ [filename/wildcard] -produces plaintext with Unix linefeeds and without markup, (object numbers -are omitted), has footnotes at end of each paragraph that contains them \ [ \ -\-A \ for \ equivalent \ dos \ (linefeed) \ output \ file] \ [see \ \-e \ for \ -endnotes]. (Options include: \-\-endnotes for endnotes \-\-footnotes for -footnotes at the end of each paragraph \-\-unix for unix linefeed (default) -\-\-msdos for msdos linefeed) - -.TP -.B \ \-b \ \ [filename/wildcard] -produces xhtml/XML output for browser viewing (sax parsing). - -.TP -.B \ \-C \ \ [\-\-init\-site] -configure/initialise shared output directory files initialize shared output -directory (config files such as css and dtd files are not updated if they -already exist unless modifier is used). \-C \-\-init\-site configure/initialise -site more extensive than \-C on its own, shared output directory files/force -update, existing shared output config files such as css and dtd files are -updated if this modifier is used. - -.TP -.B \ \-CC -\ configure/initialise \ shared \ output \ directory \ files \ initialize \ -shared \ output \ directory \ (config \ files \ such \ as \ css \ and \ dtd \ -files \ are \ not \ updated \ if \ they \ already \ exist \ unless \ modifier \ -is \ used). \ The \ equivalent \ of: \ \-C \ \-\-init\-site \ -configure/initialise \ site, \ more \ extensive \ than \ \-C \ on \ its \ own, -\ shared \ output \ directory \ files/force \ update, \ existing \ shared \ -output \ config \ files \ such \ as \ css \ and \ dtd \ files \ are \ updated \ -if \ \-CC \ is \ used. \ - -.TP -.B \ \-c \ \ [filename/wildcard] -screen toggle ansi screen colour on or off depending on default set (unless -\-c flag is used: if sisurc colour default is set to \'true\', output to screen -will be with colour, if sisurc colour default is set to \'false\' or is -undefined screen output will be without colour). - -.TP -.B \ \-D \ \ [instruction] \ [filename] -database postgresql ( \-\-pgsql may be used instead) possible instructions, -include: \-\-createdb; \-\-create; \-\-dropall; \-\-import \ [filename]; -\-\-update \ [filename]; \-\-remove \ [filename]; see database section below. - -.TP -.B \ \-d \ \ [\-\-db\-[database \ type \ (sqlite|pg)]] \-\-[instruction] \ -[filename] -database type default set to sqlite, (for which \-\-sqlite may be used -instead) or to specify another database \-\-db\-[pgsql, \ sqlite] (however see -\-D) possible instructions include: \-\-createdb; \-\-create; \-\-dropall; -\-\-import \ [filename]; \-\-update \ [filename]; \-\-remove \ [filename]; see -database section below. - -.TP -.B \ \-F \ \ [\-\-webserv=webrick] -generate examples of (naive) cgi search form for sqlite and pgsql depends on -your already having used sisu to populate an sqlite and/or pgsql database, (the -sqlite version scans the output directories for existing sisu_sqlite databases, -so it is first necessary to create them, before generating the search form) see -\-d \-D and the database section below. If the optional parameter -\-\-webserv=webrick is passed, the cgi examples created will be set up to use -the default port set for use by the webrick server, (otherwise the port is left -blank and the system setting used, usually 80). The samples are dumped in the -present work directory which must be writable, (with screen instructions given -that they be copied to the cgi\-bin directory). \-Fv (in addition to the above) -provides some information on setting up hyperestraier for sisu - -.TP -.B \ \-H \ \ [filename/wildcard] -produces html without link suffixes (.html \.pdf etc.) (\"Hide\"). Requires -an appropriately configured web server. \ [behaviour \ switched \ after \ 0.35 -\ see \ \-h]. - -.TP -.B \ \-h \ \ [filename/wildcard] -produces html (with hardlinks i.e. with name suffixes in links/local urls). -html, with internal document links that include the document suffix, i.e. -whether it is \.html or \.pdf (required for browsing directly off a file -system, and works with most web servers). \ [behaviour \ switched \ after \ -0.35 \ see \ \-H]. - -.TP -.B \ \-I \ \ [filename/wildcard] -produces texinfo and info file, (view with pinfo). - -.TP -.B \ \-L -\ prints \ license \ information. \ - -.TP -.B \ \-M \ \ [filename/wildcard/url] -maintenance mode files created for processing preserved and their locations -indicated. (also see \-V) - -.TP -.B \ \-m \ \ [filename/wildcard/url] -assumed for most other flags, creates new meta\-markup file, (the metaverse ) -that is used in all subsequent processing of other output. This step is assumed -for most processing flags. To skip it see \-n - -.TP -.B \ \-N \ \ [filename/wildcard/url] -document digest or document content certificate ( DCC ) as md5 digest tree of -the document: the digest for the document, and digests for each object -contained within the document (together with information on software versions -that produced it) (digest.txt). \-NV for verbose digest output to screen. - -.TP -.B \ \-n \ \ [filename/wildcard/url] -skip meta\-markup (building of \"metaverse\"), this skips the equivalent of -\-m which is otherwise assumed by most processing flags. - -.TP -.B \ \-o \ \ [filename/wildcard/url] -output basic document in opendocument file format (opendocument.odt). - -.TP -.B \ \-p \ \ [filename/wildcard] -produces LaTeX pdf (portrait.pdf & landscape.pdf). Default paper size is set -in config file, or document header, or provided with additional command line -parameter, e.g. \-\-papersize\-a4 preset sizes include: \'A4\', U.S. \'letter\' -and \'legal\' and book sizes \'A5\' and \'B5\' (system defaults to A4). - -.TP -.B \ \-q \ \ [filename/wildcard] -quiet less output to screen. - -.TP -.B \ \-R \ \ [filename/wildcard] -copies sisu output files to remote host using rsync. This requires that -sisurc.yml has been provided with information on hostname and username, and -that you have your \"keys\" and ssh agent in place. Note the behavior of rsync -different if \-R is used with other flags from if used alone. Alone the rsync -\-\-delete parameter is sent, useful for cleaning the remote directory (when -\-R is used together with other flags, it is not). Also see \-r - -.TP -.B \ \-r \ \ [filename/wildcard] -copies sisu output files to remote host using scp. This requires that -sisurc.yml has been provided with information on hostname and username, and -that you have your \"keys\" and ssh agent in place. Also see \-R - -.TP -.B \ \-S -\ produces \ a \ sisupod \ a \ zipped \ sisu \ directory \ of \ markup \ -files \ including \ sisu \ markup \ source \ files \ and \ the \ directories \ -local \ configuration \ file, \ images \ and \ skins. \ Note: \ this \ only \ -includes \ the \ configuration \ files \ or \ skins \ contained \ in \ \./_sisu -\ not \ those \ in \ ~/.sisu \ \-S \ \ [filename/wildcard] option. Note: (this -option is tested only with zsh). - -.TP -.B \ \-S \ \ [filename/wildcard] -produces a zipped file of the prepared document specified along with -associated images, by default named sisupod.zip they may alternatively be named -with the filename extension \.ssp This provides a quick way of gathering the -relevant parts of a sisu document which can then for example be emailed. A -sisupod includes sisu markup source file, (along with associated documents if a -master file, or available in multilingual versions), together with related -images and skin. -.B SiSU -commands can be run directly against a sisupod contained in a local -directory, or provided as a url on a remote site. As there is a security issue -with skins provided by other users, they are not applied unless the flag -\-\-trust or \-\-trusted is added to the command instruction, it is recommended -that file that are not your own are treated as untrusted. The directory -structure of the unzipped file is understood by sisu, and sisu commands can be -run within it. Note: if you wish to send multiple files, it quickly becomes -more space efficient to zip the sisu markup directory, rather than the -individual files for sending). See the \-S option without \ -[filename/wildcard]. - -.TP -.B \ \-s \ \ [filename/wildcard] -copies sisu markup file to output directory. - -.TP -.B \ \-t \ \ [filename/wildcard \ (*.termsheet.rb)] -standard form document builder, preprocessing feature - -.TP -.B \ \-U \ \ [filename/wildcard] -prints url output list/map for the available processing flags options and -resulting files that could be requested, (can be used to get a list of -processing options in relation to a file, together with information on the -output that would be produced), \-u provides url output mapping for those flags -requested for processing. The default assumes sisu_webrick is running and -provides webrick url mappings where appropriate, but these can be switched to -file system paths in sisurc.yml - -.TP -.B \ \-u \ \ [filename/wildcard] -provides url mapping of output files for the flags requested for processing, -also see \-U - -.TP -.B \ \-V -\ on \ its \ own, \ provides -.B \ SiSU -\ version \ and \ environment \ information \ (sisu \ \-\-help \ env) \ - -.TP -.B \ \-V \ \ [filename/wildcard] -even more verbose than the \-v flag. (also see \-M) - -.TP -.B \ \-v -\ on \ its \ own, \ provides -.B \ SiSU -\ version \ information \ - -.TP -.B \ \-v \ \ [filename/wildcard] -provides verbose output of what is being built, where it is being built (and -error messages if any), as with \-u flag provides a url mapping of files -created for each of the processing flag requests. See also \-V - -.TP -.B \ \-W -\ starts \ ruby\'s \ webrick \ webserver \ points \ at \ sisu \ output \ -directories, \ the \ default \ port \ is \ set \ to \ 8081 \ and \ can \ be \ -changed \ in \ the \ resource \ configuration \ files. \ \ [tip: \ the \ -webrick \ server \ requires \ link \ suffixes, \ so \ html \ output \ should \ -be \ created \ using \ the \ \-h \ option \ rather \ than \ \-H; \ also, \ note -\ \-F \ webrick \ ]. - -.TP -.B \ \-w \ \ [filename/wildcard] -produces concordance (wordmap) a rudimentary index of all the words in a -document. (Concordance files are not generated for documents of over 260,000 -words unless this limit is increased in the file sisurc.yml) - -.TP -.B \ \-X \ \ [filename/wildcard] -produces XML output with deep document structure, in the nature of dom. - -.TP -.B \ \-x \ \ [filename/wildcard] -produces XML output shallow structure (sax parsing). - -.TP -.B \ \-Y \ \ [filename/wildcard] -produces a short sitemap entry for the document, based on html output and the -sisu_manifest. \-\-sitemaps generates/updates the sitemap index of existing -sitemaps. (Experimental, \ [g,y,m \ announcement \ this \ week]) - -.TP -.B \ \-y \ \ [filename/wildcard] -produces an html summary of output generated (hyperlinked to content) and -document specific metadata (sisu_manifest.html). This step is assumed for most -processing flags. - -.TP -.B \ \-Z \ \ [filename/wildcard] -Zap, if used with other processing flags deletes output files of the type -about to be processed, prior to processing. If \-Z is used as the lone -processing related flag (or in conjunction with a combination of \-[mMvVq]), -will remove the related document output directory. - -.TP -.B \ \-z \ \ [filename/wildcard] -produces php (zend) \ [this \ feature \ is \ disabled \ for \ the \ time \ -being] - -.SH -2. COMMAND LINE MODIFIERS -.BR - -.TP -.B \ \-\-no\-ocn -\ \ [with \ \-h \ \-H \ or \ \-p] switches off object citation numbering. -Produce output without identifying numbers in margins of html or LaTeX/pdf -output. - -.TP -.B \ \-\-no\-annotate -\ strips \ output \ text \ of \ editor \ endnotes[^*1] denoted by asterisk or -dagger/plus sign - -.TP -.B \ \-\-no\-asterisk -\ strips \ output \ text \ of \ editor \ endnotes[^*2] denoted by asterisk -sign - -.TP -.B \ \-\-no\-dagger -\ strips \ output \ text \ of \ editor \ endnotes[^+1] denoted by dagger/plus -sign - -.SH -3. DATABASE COMMANDS -.BR - -.BR -dbi \- database interface - -.BR -\-D or \-\-pgsql set for postgresql \-d or \-\-sqlite default set for sqlite -\-d is modifiable with \-\-db=[database \ type \ (pgsql \ or \ sqlite)] - -.TP -.B \ \-Dv \ \-\-createall -\ initial \ step, \ creates \ required \ relations \ (tables, \ indexes) \ in -\ existing \ postgresql \ database \ (a \ database \ should \ be \ created \ -manually \ and \ given \ the \ same \ name \ as \ working \ directory, \ as \ -requested) \ (rb.dbi) \ \ [ \ \-dv \ \-\-createall \ sqlite \ equivalent] it -may be necessary to run sisu \-Dv \-\-createdb initially NOTE: at the present -time for postgresql it may be necessary to manually create the database. The -command would be \'createdb \ [database \ name]\' where database name would be -SiSU_[present \ working \ directory \ name \ (without \ path)]. Please use only -alphanumerics and underscores. - -.TP -.B \ \-Dv \ \-\-import -\ \ [filename/wildcard] imports data specified to postgresql db (rb.dbi) \ [ -\ \-dv \ \-\-import \ sqlite \ equivalent] - -.TP -.B \ \-Dv \ \-\-update -\ \ [filename/wildcard] updates/imports specified data to postgresql db -(rb.dbi) \ [ \ \-dv \ \-\-update \ sqlite \ equivalent] - -.TP -.B \ \-D \ \-\-remove -\ \ [filename/wildcard] removes specified data to postgresql db (rb.dbi) \ [ -\ \-d \ \-\-remove \ sqlite \ equivalent] - -.TP -.B \ \-D \ \-\-dropall -\ kills \ data\" \ and \ drops \ (postgresql \ or \ sqlite) \ db, \ tables \ -& \ indexes \ \ [ \ \-d \ \-\-dropall \ sqlite \ equivalent] - -.BR -The v in e.g. \-Dv is for verbose output. - -.SH -4. SHORTCUTS, SHORTHAND FOR MULTIPLE FLAGS -.BR - -.TP -.B \ \-\-update \ \ [filename/wildcard] -Checks existing file output and runs the flags required to update this -output. This means that if only html and pdf output was requested on previous -runs, only the \-hp files will be applied, and only these will be generated -this time, together with the summary. This can be very convenient, if you offer -different outputs of different files, and just want to do the same again. - -.TP -.B \ \-0 \ to \ \-5 \ \ [filename \ or \ wildcard] -Default shorthand mappings (note that the defaults can be changed/configured -in the sisurc.yml file): - -.TP -.B \ \-0 -\ \-mNhwpAobxXyYv \ \ [this \ is \ the \ default \ action \ run \ when \ no \ -options \ are \ give, \ i.e. \ on \ \'sisu \ \ [filename]\'] - -.TP -.B \ \-1 -\ \-mNHwpy \ - -.TP -.B \ \-2 -\ \-mNHwpaoy \ - -.TP -.B \ \-3 -\ \-mNhwpAobxXyY \ - -.TP -.B \ \-4 -\ \-mNhwpAobxXDyY \ \-\-import \ - -.TP -.B \ \-5 -\ \-mNhwpAobxXDyY \ \-\-update \ - -.BR -add \-v for verbose mode and \-c for color, e.g. sisu \-2vc \ [filename \ or \ -wildcard] - -.BR -consider \-u for appended url info or \-v for verbose output - -.SH -4.0.1 COMMAND LINE WITH FLAGS \- BATCH PROCESSING - -.BR -In the data directory run sisu \-mh filename or wildcard eg. \"sisu \-h -cisg.sst\" or \"sisu \-h *.{sst,ssm}\" to produce html version of all -documents. - -.BR -Running 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. - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- Commands - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-08\-28 - -.BR -DC Date issued: -.I 2002\-08\-28 - -.BR -DC Date available: -.I 2002\-08\-28 - -.BR -DC Date modified: -.I 2007\-09\-16 - -.BR -DC Date: -.I 2007\-09\-16 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_commands.sst - -.BR -Filetype: -.I SiSU text 0.58 - -.BR -Sourcefile Digest, MD5(sisu_commands.sst)= -.I 68a4087f984baffbea779da25e1b6141 - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:43 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - -.TP -.BI *1. -square brackets -.TP -.BI *2. -square brackets -.TP -.BI +1. -square brackets - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_commands/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_commands/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_commands/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_commands/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_commands/sisu_commands.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:50 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man1/sisu_configuration.1 b/man/man1/sisu_configuration.1 deleted file mode 100644 index 98c8c8c0..00000000 --- a/man/man1/sisu_configuration.1 +++ /dev/null @@ -1,368 +0,0 @@ -.TH "sisu_configuration" "1" "2007-08-30" "0.59.1" "SiSU" -.SH -SISU \- CONFIGURATION, -RALPH AMISSAH -.BR - -.SH -CONFIGURATION OF ENVIRONMENT -.BR - -.SH -1. CONFIGURATION -.BR - -.SH -1.1 DETERMINING THE CURRENT CONFIGURATION - -.BR -Information on the current configuration of -.B SiSU -should be available with the help command: - -.BR - sisu \-v - -.BR -which is an alias for: - -.BR - sisu \-\-help env - -.BR -Either of these should be executed from within a directory that contains sisu -markup source documents. - -.SH -1.2 CONFIGURATION FILES (CONFIG.YML) - -.BR -.B SiSU -configration parameters are adjusted in the configuration file, which can be -used to override the defaults set. This includes such things as which directory -interim processing should be done in and where the generated output should be -placed. - -.BR -The -.B SiSU -configuration file is a yaml file, which means indentation is significant. - -.BR -.B SiSU -resource configuration is determined by looking at the following files if -they exist: - -.BR - \./_sisu/sisurc.yml - -.BR - ~/.sisu/sisurc.yml - -.BR - /etc/sisu/sisurc.yml - -.BR -The search is in the order listed, and the first one found is used. - -.BR -In the absence of instructions in any of these it falls back to the internal -program defaults. - -.BR -Configuration determines the output and processing directories and the database -access details. - -.BR -If -.B SiSU -is installed a sample sisurc.yml may be found in /etc/sisu/sisurc.yml - -.SH -CONFIGURATION OF DOCUMENTS -.BR - -.SH -2. SKINS -.BR - -.BR -Skins modify the default appearance of document output on a document, -directory, or site wide basis. Skins are looked for in the following locations: - -.BR - \./_sisu/skin - -.BR - ~/.sisu/skin - -.BR - /etc/sisu/skin - -.BR -.B Within the skin directory -are the following the default sub\-directories for document skins: - -.BR - \./skin/doc - -.BR - \./skin/dir - -.BR - \./skin/site - -.BR -A skin is placed in the appropriate directory and the file named skin_[name].rb - -.BR -The skin itself is a ruby file which modifies the default appearances set in -the program. - -.SH -2.1 DOCUMENT SKIN - -.BR -Documents take on a document skin, if the header of the document specifies a -skin to be used. - - -.nf - @skin: skin_united_nations -.fi - -.SH -2.2 DIRECTORY SKIN - -.BR -A directory may be mapped on to a particular skin, so all documents within that -directory take on a particular appearance. If a skin exists in the skin/dir -with the same name as the document directory, it will automatically be used for -each of the documents in that directory, (except where a document specifies the -use of another skin, in the skin/doc directory). - -.BR -A personal habit is to place all skins within the doc directory, and symbolic -links as needed from the site, or dir directories as required. - -.SH -2.3 SITE SKIN - -.BR -A site skin, modifies the program default skin. - -.SH -2.4 SAMPLE SKINS - -.BR -With -.B SiSU -installed sample skins may be found in: - -.BR - /etc/sisu/skin/doc and - /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc - -.BR -(or equivalent directory) and if sisu\-markup\-samples is installed also under: - -.BR - /usr/share/doc/sisu/sisu_markup_samples/non\-free/_sisu/skin/doc - -.BR -Samples of list.yml and promo.yml (which are used to create the right column -list) may be found in: - -.BR - /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml (or equivalent - directory) - -.SH -3. HOMEPAGES -.BR - -.BR -.B SiSU -is about the ability to auto\-generate documents. Home pages are regarded as -custom built items, and are not created by -.B SiSU -. More accurately, -.B SiSU -has a default home page, which will not be appropriate for use with other -sites, and the means to provide your own home page instead in one of two ways -as part of a site\'s configuration, these being: - -.BR -1. through placing your home page and other custom built documents in the -subdirectory _sisu/home/ (this probably being the easier and more convenient -option) - -.BR -2. through providing what you want as the home page in a skin, - -.BR -Document sets are contained in directories, usually organised by site or -subject. Each directory can/should have its own homepage. See the section on -directory structure and organisation of content. - -.SH -3.1 HOME PAGE AND OTHER CUSTOM BUILT PAGES IN A SUB\-DIRECTORY - -.BR -Custom built pages, including the home page index.html may be placed within the -configuration directory _sisu/home/ in any of the locations that is searched -for the configuration directory, namely \./_sisu; ~/_sisu; /etc/sisu From there -they are copied to the root of the output directory with the command: - -.BR - sisu \-CC - -.SH -3.2 HOME PAGE WITHIN A SKIN - -.BR -Skins are described in a separate section, but basically are a file written in -the programming language -.B Ruby -that may be provided to change the defaults that are provided with sisu with -respect to individual documents, a directories contents or for a site. - -.BR -If you wish to provide a homepage within a skin the skin should be in the -directory _sisu/skin/dir and have the name of the directory for which it is to -become the home page. Documents in the directory commercial_law would have the -homepage modified in skin_commercial law.rb; or the directory poems in -skin_poems.rb - - -.nf - class Home - def homepage - # place the html content of your homepage here, this will become index.html - <<HOME <html> - <head></head> - <doc> - <p>this is my new homepage.</p> - </doc> - </html> - HOME - end - end -.fi - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- Configuration - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Ralph Amissah - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-08\-28 - -.BR -DC Date issued: -.I 2002\-08\-28 - -.BR -DC Date available: -.I 2007\-08\-28 - -.BR -DC Date modified: -.I 2007\-08\-30 - -.BR -DC Date: -.I 2007\-08\-30 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_configuration._sst - -.BR -Filetype: -.I SiSU text insert 0.58 - -.BR -Sourcefile Digest, MD5(sisu_configuration._sst)= -.I 491d3da039162d60ae0e2951aa260915 - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:46 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_configuration/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_configuration/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_configuration/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_configuration/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_configuration/sisu_configuration.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:51 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man1/sisu_help.1 b/man/man1/sisu_help.1 deleted file mode 100644 index 95331031..00000000 --- a/man/man1/sisu_help.1 +++ /dev/null @@ -1,318 +0,0 @@ -.TH "sisu_help" "1" "2007-08-30" "0.59.1" "SiSU" -.SH -SISU \- HELP, -RALPH AMISSAH -.BR - -.SH -SISU HELP -.BR - -.SH -1. HELP -.BR - -.SH -1.1 SISU MANUAL - -.BR -The most up to date information on sisu should be contained in the sisu_manual, -available at: - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/> - -.BR -and (from -.B SiSU -0.59 onwards) installed locally at: - -.BR - /usr/share/doc/sisu/sisu_manual/ - -.BR -or equivalent directory - -.BR -Within the -.B SiSU -tarball at: - -.BR - \./data/doc/sisu/sisu_manual/ - -.SH -1.2 SISU MAN PAGES - -.BR -If -.B SiSU -is installed on your system usual man commands should be available, try: - -.BR - man sisu - -.BR - man sisu_markup - -.BR - man sisu_commands - -.BR -Most -.B 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 -.B SiSU -tarball at: - -.BR - \./data/doc/sisu/sisu_manual/ - -.BR -Once installed, directory equivalent to: - -.BR - /usr/share/doc/sisu/sisu_manual/ - -.BR -Available man pages are converted back to html using man2html: - -.BR - /usr/share/doc/sisu/html/ - -.BR - \./data/doc/sisu/html/ - -.BR -The -.B SiSU -man pages can be viewed online at:[^1] - -.BR -An online version of the sisu man page is available here: - -.BR -* various sisu man pages <http://www.jus.uio.no/sisu/man/> \ [^2] - -.BR -* sisu.1 <http://www.jus.uio.no/sisu/man/sisu.1.html> \ [^3] - -.BR -* sisu.8 <http://www.jus.uio.no/sisu/man/sisu.8.html> \ [^4] - -.BR -* sisu_examples.1 <http://www.jus.uio.no/sisu/man/sisu_examples.1.html> \ [^5] - -.BR -* sisu_webrick.1 <http://www.jus.uio.no/sisu/man/sisu_webrick.1.html> \ [^6] - -.SH -1.3 SISU BUILT\-IN INTERACTIVE HELP - -.BR -This is particularly useful when current installation information is obtained -as the interactive help is able to provide information on your sisu -configuration and setup. - -.BR - sisu \-\-help - -.BR - sisu \-\-help \ [subject] - -.BR - sisu \-\-help env \ [for \ feedback \ on \ the \ way \ your \ system \ is \ - setup \ with \ regard \ to \ sisu] - -.BR - sisu \-V \ [same \ as \ above \ command] - -.BR - sisu \-\-help commands - -.BR - sisu \-\-help markup - -.BR -Apart from real\-time information on your current configuration the -.B 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). - -.BR -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. - -.SH -1.4 HELP SOURCES - -.BR -For lists of alternative help sources, see: - -.BR -.B man page - -.BR - man sisu_help_sources - -.BR -.B man2html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html - -.BR -.B sisu generated html - -.BR - /usr/share/doc/sisu/html/sisu_help_sources/index.html - -.BR - <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html> - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_help/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- Help - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-08\-28 - -.BR -DC Date issued: -.I 2002\-08\-28 - -.BR -DC Date available: -.I 2002\-08\-28 - -.BR -DC Date modified: -.I 2007\-08\-30 - -.BR -DC Date: -.I 2007\-08\-30 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_help.sst - -.BR -Filetype: -.I SiSU text 0.58 - -.BR -Sourcefile Digest, MD5(sisu_help.sst)= -.I 66d04ba5f3dd4ede774ffa5549b3faba - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:42 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - -.TP -.BI 1. -generated from source using rman - <http://polyglotman.sourceforge.net/rman.html> - With regard to -.B SiSU -man pages the formatting generated for markup syntax is not quite right, for -that you might prefer the links under: - <http://www.jus.uio.no/sample> -.TP -.BI 2. -<http://www.jus.uio.no/sisu/man/> -.TP -.BI 3. -<http://www.jus.uio.no/sisu/man/sisu.1.html> -.TP -.BI 4. -<http://www.jus.uio.no/sisu/man/sisu.8.html> -.TP -.BI 5. -<http://www.jus.uio.no/sisu/man/sisu_examples.1.html> -.TP -.BI 6. -<http://www.jus.uio.no/sisu/man/sisu_webrick.1.html> - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_help/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_help/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_help/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_help/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_help/sisu_help.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:50 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man1/sisu_help_sources.1 b/man/man1/sisu_help_sources.1 deleted file mode 100644 index 2b907a23..00000000 --- a/man/man1/sisu_help_sources.1 +++ /dev/null @@ -1,729 +0,0 @@ -.TH "sisu_help_sources" "1" "2007-09-16" "0.59.1" "SiSU" -.SH -SISU \- REFERENCES, -RALPH AMISSAH -.BR - -.SH -SISU HELP SOURCES -.BR - -.SH -1. HELP SOURCES -.BR - -.BR -For a summary of alternative ways to get help on -.B SiSU -try one of the following: - -.BR -.B man page - -.BR - man sisu_help - -.BR -.B man2html - -.BR - <file:///usr/share/doc/sisu/html/sisu_help.1.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_help.1.html> - -.BR -.B sisu generated output \- links to html - -.BR - <file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_help/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html> - -.BR -.B help sources lists - -.BR -Alternative sources for this help sources page listed here: - -.BR - man sisu_help_sources - -.BR - <file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html> - -.BR - <file:///usr/share/doc/sisu/html/sisu_help_sources/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html> - -.SH -1.1 MAN PAGES - -.SH -1.1.1 MAN - -.BR - man sisu - -.BR - man sisu_commands - -.BR - man 7 sisu_complete - -.BR - man sisu_configuration - -.BR - man 8 sisu_faq - -.BR - man sisu_filetypes - -.BR - man sisu_help - -.BR - man sisu_help_sources - -.BR - man 8 sisu_howto - -.BR - man sisu_introduction - -.BR - man sisu_markup - -.BR - man sisu_output_overview - -.BR - man 7 sisu_pdf - -.BR - man 7 sisu_postgresql - -.BR - man 8 sisu_quickstart - -.BR - man 8 sisu_remote - -.BR - man 8 sisu_search - -.BR - man sisu_skin - -.BR - man 7 sisu_sqlite - -.BR - man 8 sisu_syntax_highlighting - -.BR - man 7 sisu_vim - -.BR - man sisu_webrick - -.SH -1.2 SISU GENERATED OUTPUT \- LINKS TO HTML - -.BR -Note -.B SiSU -documentation is prepared in -.B SiSU -and output is available in multiple formats including amongst others html, -pdf, and odf which may be also be accessed via the html pages[^1] - -.SH -1.2.1 LOCALLY INSTALLED - -.BR -<file:///usr/share/doc/sisu/sisu_manual/sisu_manual/index.html> - -.BR -<file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html> - -.BR -<file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html> - -.BR - /usr/share/doc/sisu/sisu_manual/sisu/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_commands/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_complete/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_configuration/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_description/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_examples/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_faq/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_filetypes/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_help/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_howto/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_introduction/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_manual/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_markup/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_output_overview/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_pdf/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_postgresql/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_quickstart/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_remote/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_search/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_skin/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_sqlite/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_syntax_highlighting/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_vim/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_webrick/index.html - -.SH -1.2.2 WWW.SISUDOC.ORG - -.BR -<http://sisudoc.org/sisu_manual/sisu_manual/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_commands/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_complete/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_configuration/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_description/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_examples/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_faq/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_filetypes/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_help/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_howto/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_introduction/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_manual/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_markup/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_output_overview/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_pdf/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_postgresql/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_quickstart/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_remote/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_search/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_skin/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_sqlite/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_syntax_highlighting/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_vim/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_webrick/index.html> - -.SH -1.2.3 WWW.JUS.UIO.NO/SISU - -.BR -<http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_complete/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_description/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_examples/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_filetypes/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_introduction/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_output_overview/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_pdf/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_postgresql/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_search/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_sqlite/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_vim/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_webrick/index.html> - -.SH -1.2.4 MAN2HTML - -.SH -1.2.5 LOCALLY INSTALLED - -.BR -<file:///usr/share/doc/sisu/html/sisu_manual.1.html> - -.BR -<file:///usr/share/doc/sisu/html/sisu_help.1.html> - -.BR -<file:///usr/share/doc/sisu/html/sisu_help_sources.1.html> - -.BR - /usr/share/doc/sisu/html/sisu.1.html - -.BR - /usr/share/doc/sisu/html/sisu_commands.1.html - -.BR - /usr/share/doc/sisu/html/sisu_complete.7.html - -.BR - /usr/share/doc/sisu/html/sisu_configuration.1.html - -.BR - /usr/share/doc/sisu/html/sisu_faq.8.html - -.BR - /usr/share/doc/sisu/html/sisu_help.1.html - -.BR - /usr/share/doc/sisu/html/sisu_help_sources.1.html - -.BR - /usr/share/doc/sisu/html/sisu_howto.8.html - -.BR - /usr/share/doc/sisu/html/sisu_markup.1.html - -.BR - /usr/share/doc/sisu/html/sisu_pdf.7.html - -.BR - /usr/share/doc/sisu/html/sisu_postgresql.7.html - -.BR - /usr/share/doc/sisu/html/sisu_quickstart.8.html - -.BR - /usr/share/doc/sisu/html/sisu_remote.8.html - -.BR - /usr/share/doc/sisu/html/sisu_search.8.html - -.BR - /usr/share/doc/sisu/html/sisu_skin.1.html - -.BR - /usr/share/doc/sisu/html/sisu_sqlite.7.html - -.BR - /usr/share/doc/sisu/html/sisu_syntax_highlighting.8.html - -.BR - /usr/share/doc/sisu/html/sisu_vim.7.html - -.BR - /usr/share/doc/sisu/html/sisu_webrick.1.html - -.SH -1.2.6 WWW.SISUDOC.ORG - -.BR -<http:///sisudoc.org/man/sisu_manual.1.html> - -.BR -<http:///sisudoc.org/man/sisu_help.1.html> - -.BR -<http:///sisudoc.org/man/sisu_help_sources.1.html> - -.BR - <http://sisudoc.org/man/sisu.1.html> - -.BR - <http://sisudoc.org/man/sisu_commands.1.html> - -.BR - <http://sisudoc.org/man/sisu_complete.7.html> - -.BR - <http://sisudoc.org/man/sisu_configuration.1.html> - -.BR - <http://sisudoc.org/man/sisu_faq.8.html> - -.BR - <http://sisudoc.org/man/sisu_help.1.html> - -.BR - <http://sisudoc.org/man/sisu_help_sources.1.html> - -.BR - <http://sisudoc.org/man/sisu_howto.8.html> - -.BR - <http://sisudoc.org/man/sisu_markup.1.html> - -.BR - <http://sisudoc.org/man/sisu_pdf.7.html> - -.BR - <http://sisudoc.org/man/sisu_postgresql.7.html> - -.BR - <http://sisudoc.org/man/sisu_quickstart.8.html> - -.BR - <http://sisudoc.org/man/sisu_remote.8.html> - -.BR - <http://sisudoc.org/man/sisu_search.8.html> - -.BR - <http://sisudoc.org/man/sisu_skin.1.html> - -.BR - <http://sisudoc.org/man/sisu_sqlite.7.html> - -.BR - <http://sisudoc.org/man/sisu_syntax_highlighting.8.html> - -.BR - <http://sisudoc.org/man/sisu_vim.7.html> - -.BR - <http://sisudoc.org/man/sisu_webrick.1.html> - -.SH -1.2.7 WWW.JUS.UIO.NO/SISU - -.BR -<http://www.jus.uio.no/sisu/man/sisu_manual.1.html> - -.BR -<http://www.jus.uio.no/sisu/man/sisu_help.1.html> - -.BR -<http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu.1.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_commands.1.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_complete.7.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_configuration.1.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_faq.8.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_help.1.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_howto.8.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_markup.1.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_pdf.7.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_postgresql.7.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_quickstart.8.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_remote.8.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_search.8.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_skin.1.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_sqlite.7.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_syntax_highlighting.8.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_vim.7.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_webrick.1.html> - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- References - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-11\-12 - -.BR -DC Date issued: -.I 2002\-11\-12 - -.BR -DC Date available: -.I 2002\-11\-12 - -.BR -DC Date modified: -.I 2007\-09\-16 - -.BR -DC Date: -.I 2007\-09\-16 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_help_sources.sst - -.BR -Filetype: -.I SiSU text insert 0.58 - -.BR -Sourcefile Digest, MD5(sisu_help_sources.sst)= -.I ff6812b3008391d7a20d777bbbeb3ec1 - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:42 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - -.TP -.BI 1. -named index.html or more extensively through sisu_manifest.html - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_help_sources/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_help_sources/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_help_sources/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_help_sources/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_help_sources/sisu_help_sources.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:50 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man1/sisu_markup.1 b/man/man1/sisu_markup.1 deleted file mode 100644 index d8e58032..00000000 --- a/man/man1/sisu_markup.1 +++ /dev/null @@ -1,1532 +0,0 @@ -.TH "sisu_markup" "1" "2007-09-16" "0.59.1" "SiSU" -.SH -SISU \- MARKUP, -RALPH AMISSAH -.BR - -.SH -SISU MARKUP -.BR - -.SH -1. INTRODUCTION TO SISU MARKUP[^1] -.BR - -.SH -1.1 SUMMARY - -.BR -.B SiSU -source documents are plaintext (UTF\-8)[^2] files - -.BR -All paragraphs are separated by an empty line. - -.BR -Markup is comprised of: - -.BR -* at the top of a document, the document header made up of semantic meta\-data -about the document and if desired additional processing instructions (such an -instruction to automatically number headings from a particular level down) - -.BR -* followed by the prepared substantive text of which the most important single -characteristic is the markup of different heading levels, which define the -primary outline of the document structure. Markup of substantive text includes: - -.BR - * heading levels defines document structure - -.BR - * text basic attributes, italics, bold etc. - -.BR - * grouped text (objects), which are to be treated differently, such as code - blocks or poems. - -.BR - * footnotes/endnotes - -.BR - * linked text and images - -.BR - * paragraph actions, such as indent, bulleted, numbered\-lists, etc. - -.BR -Some interactive help on markup is available, by typing sisu and selecting -markup or sisu \-\-help markup - -.SH -1.2 MARKUP EXAMPLES - -.SH -1.2.1 ONLINE - -.BR -Online markup examples are available together with the respective outputs -produced from <http://www.jus.uio.no/sisu/SiSU/2.html> or from -<http://www.jus.uio.no/sisu/sisu_examples/> - -.BR -There is of course this document, which provides a cursory overview of sisu -markup and the respective output produced: -<http://www.jus.uio.no/sisu/sisu_markup/> - -.BR -Some example marked up files are available as html with syntax highlighting for -viewing: <http://www.jus.uio.no/sisu/sample/syntax> - -.BR -an alternative presentation of markup syntax: -<http://www.jus.uio.no/sisu/sample/on_markup.txt> - -.SH -1.2.2 INSTALLED - -.BR -With -.B SiSU -installed sample skins may be found in: -/usr/share/doc/sisu/sisu_markup_samples/dfsg (or equivalent directory) and if -sisu\-markup\-samples is installed also under: -/usr/share/doc/sisu/sisu_markup_samples/non\-free - -.SH -2. MARKUP OF HEADERS -.BR - -.BR -Headers consist of semantic meta\-data about a document, which can be used by -any output module of the program; and may in addition include extra processing -instructions. - -.BR -Note: the first line of a document may include information on the markup -version used in the form of a comment. Comments are a percentage mark at the -start of a paragraph (and as the first character in a line of text) followed by -a space and the comment: - - -.nf - % this would be a comment -.fi - -.SH -2.1 SAMPLE HEADER - -.BR -This current document has a header similar to this one (without the comments): - - -.nf - % SiSU 0.57 - @title: SiSU - @subtitle: Markup - @creator: Ralph Amissah - @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\-09\-16 - @date: 2007\-09\-16 - @level: new=C; break=1; num_top=1 - % comment: in this @level header num_top=1 starts automatic heading numbering at heading level 1 (numbering continues 3 levels down); the new and break instructions are used by the LaTeX/pdf and odf output to determine where to put page breaks (that are not used by html output or say sql database population). - @skin: skin_sisu_manual - % skins modify the appearance of a document and are placed in a sub\-directory under \./_sisu/skin ~/.sisu/skin or /etc/sisu/skin. A skin may affect single documents that request them, all documents in a directory, or be site\-wide. (A document is affected by a single skin) - @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/2.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 -.fi - -.SH -2.2 AVAILABLE HEADERS - -.BR -Header tags appear at the beginning of a document and provide meta information -on the document (such as the Dublin Core), or information as to how the -document as a whole is to be processed. All header instructions take either the -form @headername: or 0~headername. All Dublin Core meta tags are available - -.BR -.B @indentifier: -information or instructions - -.BR -where the \"identifier\" is a tag recognised by the program, and the -\"information\" or \"instructions\" belong to the tag/indentifier specified - -.BR -Note: a header where used should only be used once; all headers apart from -@title: are optional; the @structure: header is used to describe document -structure, and can be useful to know. - -.BR -This is a sample header - -.BR -.B % SiSU 0.38 -\ [declared \ file\-type \ identifier \ with \ markup \ version] - -.BR -.B @title: -\ [title \ text] This is the title of the document and used as such, this -header is the only one that is -.I mandatory - -.BR -.B @subtitle: -The Subtitle if any - -.BR -.B @creator: -\ [or \ @author:] Name of Author - -.BR -.B @subject: -(whatever your subject) - -.BR -.B @description: - -.BR -.B @publisher: - -.BR -.B @contributor: - -.BR -.B @translator: -\ [or \ @translated_by:] - -.BR -.B @illustrator: -\ [or \ @illustrated_by:] - -.BR -.B @prepared_by: -\ [or \ @digitized_by:] - -.BR -.B @date: 2000\-08\-27 -\ [ \ also \ @date.created: \ @date.issued: \ @date.available: \ @date.valid: -\ @date.modified: \ ] - -.BR -.B @type: article - -.BR -.B @format: - -.BR -.B @identifier: - -.BR -.B @source: - -.BR -.B @language: -\ [or \ @language.document:] \ [country \ code \ for \ language \ if \ -available, \ or \ language, \ English, \ en \ is \ the \ default \ setting] (en -\- English, fr \- French, de \- German, it \- Italian, es \- Spanish, pt \- -Portuguese, sv \- Swedish, da \- Danish, fi \- Finnish, no \- Norwegian, is \- -Icelandic, nl \- Dutch, et \- Estonian, hu \- Hungarian, pl \- Polish, ro \- -Romanian, ru \- Russian, el \- Greek, uk \- Ukranian, tr \- Turkish, sk \- -Slovak, sl \- Slovenian, hr \- Croatian, cs \- Czech, bg \- Bul garian ) \ -[however, \ encodings \ are \ not \ available \ for \ all \ of \ the \ -languages \ listed.] - -.BR -[@language.original: \ original \ language \ in \ which \ the \ work \ was \ -published] - -.BR -.B @papersize: -(A4|US_letter|book_B5|book_A5|US_legal) - -.BR -.B @relation: - -.BR -.B @coverage: - -.BR -.B @rights: -Copyright (c) Name of Right Holder, all rights reserved, or as granted: -public domain, copyleft, creative commons variant, etc. - -.BR -.B @owner: - -.BR -.B @keywords: -text document generation processing management latex pdf structured xml -citation \ [your \ keywords \ here, \ used \ for \ example \ by \ rss \ feeds, -\ and \ in \ sql \ searches] - -.BR -.B @abstract: -\ [paper \ abstract, \ placed \ after \ table \ of \ contents] - -.BR -.B @comment: -\ [...] - -.BR -.B @catalogue: -loc=[Library \ of \ Congress \ classification]; dewey=[Dewey \ -classification]; isbn=[ISBN]; pg=[Project \ Gutenberg \ text \ number] - -.BR -.B @classify_loc: -\ [Library \ of \ Congress \ classification] - -.BR -.B @classify_dewey: -\ [Dewey \ classification] - -.BR -.B @classify_isbn: -\ [ISBN] - -.BR -.B @classify_pg: -\ [Project \ Gutenberg \ text \ number] - -.BR -.B @prefix: -\ [prefix \ is \ placed \ just \ after \ table \ of \ contents] - -.BR -.B @prefix_a: -\ [prefix \ is \ placed \ just \ before \ table \ of \ contents \ \- \ not \ -implemented] - -.BR -.B @prefix_b: - -.BR -.B @rcs: -$Id: sisu_markup.sst,v 1.2 2007/09/08 17:12:47 ralph Exp $ \ [used \ by \ rcs -\ or \ cvs \ to \ embed \ version \ (revision \ control) \ information \ into \ -document, \ rcs \ or \ cvs \ can \ usefully \ provide \ a \ history \ of \ -updates \ to \ a \ document \ ] - -.BR -.B @structure: -PART; CHAPTER; SECTION; ARTICLE; none; none; -optional, document structure can be defined by words to match or regular -expression (the regular expression is assumed to start at the beginning of a -line of text i.e. ^) default markers :A~ to :C~ and 1~ to 6~ can be used within -text instead, without this header tag, and may be used to supplement the -instructions provided in this header tag if provided (@structure: is a synonym -for @toc:) - -.BR -.B @level: -newpage=3; breakpage=4 -\ [paragraph \ level, \ used \ by \ latex \ to \ breakpages, \ the \ page \ -is \ optional \ eg. \ in \ newpage] - -.BR -.B @markup: -information on the markup used, e.g. new=1,2,3; break=4; num_top=4 \ [or \ -newpage=1,2,3; \ breakpage=4; \ num_top=4] newpage and breakpage, heading -level, used by LaTeX to breakpages. breakpage: starts on a new page in single -column text and on a new column in double column text; newpage: starts on a new -page for both single and double column texts. -num_top=4 \ [auto\-number \ document, \ starting \ at \ level \ 4. \ the \ -default \ is \ to \ provide \ 3 \ levels, \ as \ in \ 1 \ level \ 4, \ 1.1 \ -level \ 5, \ 1.1.1 \ level \ 6, \ markup \ to \ be \ merged \ within \ level] -num_extract \ [take \ numbering \ of \ headings \ provided \ (manually \ in \ -marked \ up \ source \ document), \ and \ use \ for \ numbering \ of \ -segments. \ Available \ where \ a \ clear \ numbering \ structure \ is \ -provided \ within \ document, \ without \ the \ repetition \ of \ a \ number \ -in \ a \ header.] \ [In \ 0.38 \ notation, \ you \ would \ map \ to \ the \ -equivalent \ levels, \ the \ examples \ provided \ would \ map \ to \ the \ -following \ new=A,B,C; \ break=1; \ num_top=1 \ \ [or \ newpage=A,B,C; \ -breakpage=1; \ num_top=1] see headings] - -.BR -.B @bold: -\ [regular \ expression \ of \ words/phrases \ to \ be \ made \ bold] - -.BR -.B @italics: -\ [regular \ expression \ of \ words/phrases \ to \ italicise] - -.BR -.B @vocabulary: -name of taxonomy/vocabulary/wordlist to use against document - -.BR -.B @skin: -skin_doc_[name_of_desired_document_skin] -skins change default settings related to the appearance of documents -generated, such as the urls of the home site, and the icon/logo for the -document or site. - -.BR -.B @links: -{ -.B SiSU -}http://www.jus.uio.no/sisu/; -{ FSF }http://www.fsf.org - -.BR -.B @promo: -sisu, ruby, search_libre_docs, open_society -\ [places \ content \ in \ right \ pane \ in \ html, \ makes \ use \ of \ -list.yml \ and \ promo.yml, \ commented \ out \ sample \ in \ document \ -sample: \ -free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst] - -.SH -3. MARKUP OF SUBSTANTIVE TEXT -.BR - -.SH -3.1 HEADING LEVELS - -.BR -Heading levels are :A~ ,:B~ ,:C~ ,1~ ,2~ ,3~ \... :A \- :C being part / section -headings, followed by other heading levels, and 1 \-6 being headings followed -by substantive text or sub\-headings. :A~ usually the title :A~? conditional -level 1 heading (used where a stand\-alone document may be imported into -another) - -.BR -.B :A~ \ [heading \ text] -Top level heading \ [this \ usually \ has \ similar \ content \ to \ the \ -title \ @title: \ ] NOTE: the heading levels described here are in 0.38 -notation, see heading - -.BR -.B :B~ \ [heading \ text] -Second level heading \ [this \ is \ a \ heading \ level \ divider] - -.BR -.B :C~ \ [heading \ text] -Third level heading \ [this \ is \ a \ heading \ level \ divider] - -.BR -.B 1~ \ [heading \ text] -Top level heading preceding substantive text of document or sub\-heading 2, -the heading level that would normally be marked 1. or 2. or 3. etc. in a -document, and the level on which sisu by default would break html output into -named segments, names are provided automatically if none are given (a number), -otherwise takes the form 1~my_filename_for_this_segment - -.BR -.B 2~ \ [heading \ text] -Second level heading preceding substantive text of document or sub\-heading -3, the heading level that would normally be marked 1.1 or 1.2 or 1.3 or 2.1 -etc. in a document. - -.BR -.B 3~ \ [heading \ text] -Third level heading preceding substantive text of document, that would -normally be marked 1.1.1 or 1.1.2 or 1.2.1 or 2.1.1 etc. in a document - - -.nf - 1~filename level 1 heading, - % the primary division such as Chapter that is followed by substantive text, and may be further subdivided (this is the level on which by default html segments are made) -.fi - -.SH -3.2 FONT ATTRIBUTES - -.BR -.B markup example: - - -.nf - normal text !{emphasis}! *{bold text}* _{underscore}_ /{italics}/ \"{citation}\" ^{superscript}^ ,{subscript}, +{inserted text}+ - normal text - !{emphasis}! - *{bold text}* - _{underscore} - /{italics}/ - \"{citation}\" - ^{superscript}^ - ,{subscript}, - +{inserted text}+ - \-{strikethrough}\- -.fi - -.BR -.B resulting output: - -.BR -normal text <em>emphasis</em> -.B bold text -.I underscore -.I italics -<cite>citation</cite> ^superscript^ \ [subscript] <ins>inserted text</ins> -<del>strikethrough</del> - -.BR -normal text - -.BR -<em>emphasis</em> - -.BR -.B bold text - -.BR -.I underscore - -.BR -.I italics - -.BR -<cite>citation</cite> - -.BR -^superscript^ - -.BR -[subscript] - -.BR -<ins>inserted text</ins> - -.BR -<del>strikethrough</del> - -.SH -3.3 INDENTATION AND BULLETS - -.BR -.B markup example: - - -.nf - ordinary paragraph - _1 indent paragraph one step - _2 indent paragraph two steps - _9 indent paragraph nine steps -.fi - -.BR -.B resulting output: - -.BR -ordinary paragraph - -.BR - indent paragraph one step - -.BR - indent paragraph two steps - -.BR - indent paragraph nine steps - -.BR -.B markup example: - - -.nf - * bullet text - _1* bullet text, first indent - _2* bullet text, two step indent -.fi - -.BR -.B resulting output: - -.BR -* bullet text - -.BR - * bullet text, first indent - -.BR - * bullet text, two step indent - -.BR -Numbered List (not to be confused with headings/titles, (document structure)) - -.BR -.B markup example: - - -.nf - # numbered list numbered list 1., 2., 3, etc. - _# numbered list numbered list indented a., b., c., d., etc. -.fi - -.SH -3.4 FOOTNOTES / ENDNOTES - -.BR -Footnotes and endnotes not distinguished in markup. They are automatically -numbered. Depending on the output file format (html, odf, pdf etc.), the -document output selected will have either footnotes or endnotes. - -.BR -.B markup example: - - -.nf - ~{ a footnote or endnote }~ -.fi - -.BR -.B resulting output: - -.BR -[^3] - -.BR -.B markup example: - - -.nf - normal text~{ self contained endnote marker & endnote in one }~ continues -.fi - -.BR -.B resulting output: - -.BR -normal text[^4] continues - -.BR -.B markup example: - - -.nf - normal text ~{* unnumbered asterisk footnote/endnote, insert multiple asterisks if required }~ continues - normal text ~{** another unnumbered asterisk footnote/endnote }~ continues -.fi - -.BR -.B resulting output: - -.BR -normal text \ [^*] continues - -.BR -normal text \ [^**] continues - -.BR -.B markup example: - - -.nf - normal text ~[* \ editors \ notes, \ numbered \ asterisk \ footnote/endnote \ series \ ]~ continues - normal text ~[+ \ editors \ notes, \ numbered \ asterisk \ footnote/endnote \ series \ ]~ continues -.fi - -.BR -.B resulting output: - -.BR -normal text \ [^*1] continues - -.BR -normal text \ [^+1] continues - -.BR -.B Alternative endnote pair notation for footnotes/endnotes: - - -.nf -.nf - % note the endnote marker \"~^\" - normal text~^ continues - ^~ endnote text following the paragraph in which the marker occurs -.fi - -.BR -the standard and pair notation cannot be mixed in the same document - -.SH -3.5 LINKS - -.SH -3.5.1 NAKED URLS WITHIN TEXT, DEALING WITH URLS - -.BR -urls are found within text and marked up automatically. A url within text is -automatically hyperlinked to itself and by default decorated with angled -braces, unless they are contained within a code block (in which case they are -passed as normal text), or escaped by a preceding underscore (in which case the -decoration is omitted). - -.BR -.B markup example: - - -.nf - normal text http://www.jus.uio.no/sisu continues -.fi - -.BR -.B resulting output: - -.BR -normal text <http://www.jus.uio.no/sisu> continues - -.BR -An escaped url without decoration - -.BR -.B markup example: - - -.nf - normal text http://www.jus.uio.no/sisu continues - deb http://www.jus.uio.no/sisu/archive unstable main non\-free -.fi - -.BR -.B resulting output: - -.BR -normal text http://www.jus.uio.no/sisu continues - -.BR -deb http://www.jus.uio.no/sisu/archive unstable main non\-free - -.BR -where a code block is used there is neither decoration nor hyperlinking, code -blocks are discussed later in this document - -.BR -.B resulting output: - - -.nf - deb http://www.jus.uio.no/sisu/archive unstable main non\-free - deb\-src http://www.jus.uio.no/sisu/archive unstable main non\-free -.fi - -.BR -To link text or an image to a url the markup is as follows - -.BR -.B markup example: - - -.nf - about { SiSU }http://url.org markup -.fi - -.SH -3.5.2 LINKING TEXT - -.BR -.B resulting output: - -.BR -about SiSU <http://www.jus.uio.no/sisu/> markup - -.BR -A shortcut notation is available so the url link may also be provided -automatically as a footnote - -.BR -.B markup example: - - -.nf - about {~^ SiSU }http://url.org markup -.fi - -.BR -.B resulting output: - -.BR -about SiSU <http://www.jus.uio.no/sisu/> \ [^5] markup - -.SH -3.5.3 LINKING IMAGES - -.BR -.B markup example: - - -.nf - [ tux.png ] - % various url linked images - [ tux.png ] - [ GnuDebianLinuxRubyBetterWay.png ] - {~^ ruby_logo.png \"Ruby\" }http://www.ruby\-lang.org/en/ -.fi - -.BR -.B resulting output: - -.BR -[ tux.png ] - -.BR -tux.png 64x80 \"Gnu/Linux \- a better way\" <http://www.jus.uio.no/sisu/> - -.BR -[ \ ruby_logo \ (png \ missing) \ ] \ [^6] - -.BR -GnuDebianLinuxRubyBetterWay.png 100x101 \"Way Better \- with Gnu/Linux, Debian -and Ruby\" <http://www.jus.uio.no/sisu/> - -.BR -.B linked url footnote shortcut - - -.nf - {~^ \ [text \ to \ link] }http://url.org - % maps to: { \ [text \ to \ link] }http://url.org ~{ http://url.org }~ - % which produces hyper\-linked text within a document/paragraph, with an endnote providing the url for the text location used in the hyperlink -.fi - - -.nf - text marker *~name -.fi - -.BR -note at a heading level the same is automatically achieved by providing names -to headings 1, 2 and 3 i.e. 2~[name] and 3~[name] or in the case of -auto\-heading numbering, without further intervention. - -.SH -3.6 GROUPED TEXT - -.SH -3.6.1 TABLES - -.BR -Tables may be prepared in two either of two forms - -.BR -.B markup example: - - -.nf - table{ c3; 40; 30; 30; - This is a table - this would become column two of row one - column three of row one is here - And here begins another row - column two of row two - column three of row two, and so on - }table -.fi - -.BR -.B resulting output: - - \ [table \ omitted, \ see \ other \ document \ formats] - -.BR -a second form may be easier to work with in cases where there is not much -information in each column - -.BR -.B markup example: -[^7] - - -.nf - !_ Table 3.1: Contributors to Wikipedia, January 2001 \- June 2005 - {table~h 24; 12; 12; 12; 12; 12; 12;} - |Jan. 2001|Jan. 2002|Jan. 2003|Jan. 2004|July 2004|June 2006 - Contributors* | 10| 472| 2,188| 9,653| 25,011| 48,721 - Active contributors** | 9| 212| 846| 3,228| 8,442| 16,945 - Very active contributors*** | 0| 31| 190| 692| 1,639| 3,016 - No. of English language articles| 25| 16,000| 101,000| 190,000| 320,000| 630,000 - No. of articles, all languages | 25| 19,000| 138,000| 490,000| 862,000|1,600,000 - \\* Contributed at least ten times; \\** at least 5 times in last month; \\*\** more than 100 times in last month. -.fi - -.BR -.B resulting output: - -.BR -.B Table 3.1: Contributors to Wikipedia, January 2001 \- June 2005 - - \ [table \ omitted, \ see \ other \ document \ formats] - -.BR -* Contributed at least ten times; ** at least 5 times in last month; *** more -than 100 times in last month. - -.SH -3.6.2 POEM - -.BR -.B basic markup: - - -.nf - poem{ - Your poem here - }poem - Each verse in a poem is given a separate object number. -.fi - -.BR -.B markup example: - - -.nf - poem{ - \'Fury said to a - mouse, That he - met in the - house, - \"Let us - both go to - law: I will - prosecute - YOU. \-\-Come, - I\'ll take no - denial; We - must have a - trial: For - really this - morning I\'ve - nothing - to do.\" - Said the - mouse to the - cur, \"Such - a trial, - dear Sir, - With - no jury - or judge, - would be - wasting - our - breath.\" - \"I\'ll be - judge, I\'ll - be jury,\" - Said - cunning - old Fury: - \"I\'ll - try the - whole - cause, - and - condemn - you - to - death.\"\' - }poem -.fi - -.BR -.B resulting output: - - - \'Fury said to a -.P - mouse, That he -.P - met in the -.P - house, -.P - \"Let us -.P - both go to -.P - law: I will -.P - prosecute -.P - YOU. \-\-Come, -.P - I\'ll take no -.P - denial; We -.P - must have a -.P - trial: For -.P - really this -.P - morning I\'ve -.P - nothing -.P - to do.\" -.P - Said the -.P - mouse to the -.P - cur, \"Such -.P - a trial, -.P - dear Sir, -.P - With -.P - no jury -.P - or judge, -.P - would be -.P - wasting -.P - our -.P - breath.\" -.P - \"I\'ll be -.P - judge, I\'ll -.P - be jury,\" -.P - Said -.P - cunning -.P - old Fury: -.P - \"I\'ll -.P - try the -.P - whole -.P - cause, -.P - and -.P - condemn -.P - you -.P - to -.P - death.\"\' -.P - -.SH -3.6.3 GROUP - -.BR -.B basic markup: - - -.nf - group{ - Your grouped text here - }group - A group is treated as an object and given a single object number. -.fi - -.BR -.B markup example: - - -.nf - group{ - \'Fury said to a - mouse, That he - met in the - house, - \"Let us - both go to - law: I will - prosecute - YOU. \-\-Come, - I\'ll take no - denial; We - must have a - trial: For - really this - morning I\'ve - nothing - to do.\" - Said the - mouse to the - cur, \"Such - a trial, - dear Sir, - With - no jury - or judge, - would be - wasting - our - breath.\" - \"I\'ll be - judge, I\'ll - be jury,\" - Said - cunning - old Fury: - \"I\'ll - try the - whole - cause, - and - condemn - you - to - death.\"\' - }group -.fi - -.BR -.B resulting output: - - - \'Fury said to a -.P - mouse, That he -.P - met in the -.P - house, -.P - \"Let us -.P - both go to -.P - law: I will -.P - prosecute -.P - YOU. \-\-Come, -.P - I\'ll take no -.P - denial; We -.P - must have a -.P - trial: For -.P - really this -.P - morning I\'ve -.P - nothing -.P - to do.\" -.P - Said the -.P - mouse to the -.P - cur, \"Such -.P - a trial, -.P - dear Sir, -.P - With -.P - no jury -.P - or judge, -.P - would be -.P - wasting -.P - our -.P - breath.\" -.P - \"I\'ll be -.P - judge, I\'ll -.P - be jury,\" -.P - Said -.P - cunning -.P - old Fury: -.P - \"I\'ll -.P - try the -.P - whole -.P - cause, -.P - and -.P - condemn -.P - you -.P - to -.P - death.\"\' -.P - -.SH -3.6.4 CODE - -.BR -Code tags are used to escape regular sisu markup, and have been used -extensively within this document to provide examples of -.B SiSU -markup. You cannot however use code tags to escape code tags. They are -however used in the same way as group or poem tags. - -.BR -A code\-block is treated as an object and given a single object number. \ [an \ -option \ to \ number \ each \ line \ of \ code \ may \ be \ considered \ at \ -some \ later \ time] - -.BR -.B use of code tags instead of poem compared, resulting output: - - -.nf - \'Fury said to a - mouse, That he - met in the - house, - \"Let us - both go to - law: I will - prosecute - YOU. \-\-Come, - I\'ll take no - denial; We - must have a - trial: For - really this - morning I\'ve - nothing - to do.\" - Said the - mouse to the - cur, \"Such - a trial, - dear Sir, - With - no jury - or judge, - would be - wasting - our - breath.\" - \"I\'ll be - judge, I\'ll - be jury,\" - Said - cunning - old Fury: - \"I\'ll - try the - whole - cause, - and - condemn - you - to - death.\"\' -.fi - -.SH -4. COMPOSITE DOCUMENTS MARKUP -.BR - -.BR -It is possible to build a document by creating a master document that requires -other documents. The documents required may be complete documents that could be -generated independently, or they could be markup snippets, prepared so as to be -easily available to be placed within another text. If the calling document is a -master document (built from other documents), it should be named with the -suffix -.B \.ssm -Within this document you would provide information on the other documents -that should be included within the text. These may be other documents that -would be processed in a regular way, or markup bits prepared only for inclusion -within a master document -.B \.sst -regular markup file, or -.B \.ssi -(insert/information) A secondary file of the composite document is built -prior to processing with the same prefix and the suffix -.B \._sst - -.BR -basic markup for importing a document into a master document - - -.nf - << |filename1.sst|@|^| - << |filename2.ssi|@|^| -.fi - -.BR -The form described above should be relied on. Within the Vim editor it results -in the text thus linked becoming hyperlinked to the document it is calling in -which is convenient for editing. Alternative markup for importation of -documents under consideration, and occasionally supported have been. - - -.nf - r{filename} - {filename.ssi}require - << {filename.ssi} - % using textlink alternatives - |filename.ssi|@|^|require - << |filename.ssi|@|^| - % using thlnk alternatives - <url:filename.ssi>require - << <url:filename.ssi> -.fi - -.SH -MARKUP SYNTAX HISTORY -.BR - -.SH -5. NOTES RELATED TO FILES\-TYPES AND MARKUP SYNTAX -.BR - -.BR -0.38 is substantially current, depreciated 0.16 supported, though file names -were changed at 0.37 - -.BR -.B 0.52 -(2007w14/6) declared document type identifier at start of text/document: - -.BR - .B SiSU -0.52 - -.BR -or, backward compatible using the comment marker: - -.BR - % -.B SiSU -0.38 - -.BR -variations include \' -.B SiSU -(text|master|insert) \ [version]\' and \'sisu\-[version]\' - -.BR -.B 0.51 -(2007w13/6) skins changed (simplified), markup unchanged - -.BR -.B 0.42 -(2006w27/4) * (asterisk) type endnotes, used e.g. in relation to author - -.BR -.B 0.38 -(2006w15/7) introduced new/alternative notation for headers, e.g. @title: -(instead of 0~title), and accompanying document structure markup, -:A,:B,:C,1,2,3 (maps to previous 1,2,3,4,5,6) - -.BR -.B 0.37 -(2006w09/7) introduced new file naming convention, \.sst (text), \.ssm -(master), \.ssi (insert), markup syntax unchanged - -.BR -.B 0.35 -(2005w52/3) sisupod, zipped content file introduced - -.BR -.B 0.23 -(2005w36/2) utf\-8 for markup file - -.BR -.B 0.22 -(2005w35/3) image dimensions may be omitted if rmagick is available to be -relied upon - -.BR -.B 0.20.4 -(2005w33/4) header 0~links - -.BR -.B 0.16 -(2005w25/2) substantial changes introduced to make markup cleaner, header -0~title type, and headings \ [1\-6]~ introduced, also percentage sign (%) at -start of a text line as comment marker - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- Markup - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-08\-28 - -.BR -DC Date issued: -.I 2002\-08\-28 - -.BR -DC Date available: -.I 2002\-08\-28 - -.BR -DC Date modified: -.I 2007\-09\-16 - -.BR -DC Date: -.I 2007\-09\-16 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_markup.sst - -.BR -Filetype: -.I SiSU text 0.58 - -.BR -Sourcefile Digest, MD5(sisu_markup.sst)= -.I 6848f40f5844e0a7d59dbb86b3ddae92 - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:43 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - -.TP -.BI 1. -From sometime after SiSU 0.58 it should be possible to describe SiSU markup -using SiSU, which though not an original design goal is useful. -.TP -.BI 2. -files should be prepared using UTF-8 character encoding -.TP -.BI 3. -a footnote or endnote -.TP -.BI 4. -self contained endnote marker & endnote in one -.TP -.BI *. -unnumbered asterisk footnote/endnote, insert multiple asterisks if required -.TP -.BI **. -another unnumbered asterisk footnote/endnote -.TP -.BI *1. -editors notes, numbered asterisk footnote/endnote series -.TP -.BI +1. -editors notes, numbered asterisk footnote/endnote series -.TP -.BI 5. -<http://www.jus.uio.no/sisu/> -.TP -.BI 6. -<http://www.ruby-lang.org/en/> -.TP -.BI 7. -Table from the Wealth of Networks by Yochai Benkler - <http://www.jus.uio.no/sisu/the_wealth_of_networks.yochai_benkler> - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_markup/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_markup/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_markup/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_markup/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_markup/sisu_markup.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:50 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man1/sisu_skin.1 b/man/man1/sisu_skin.1 deleted file mode 100644 index 20f337d8..00000000 --- a/man/man1/sisu_skin.1 +++ /dev/null @@ -1,222 +0,0 @@ -.TH "sisu_skin" "1" "2007-09-16" "0.59.1" "SiSU" -.SH -SISU \- SKINS, -RALPH AMISSAH -.BR - -.SH -DOCUMENT SKINS \- CONFIGURATION -.BR - -.SH -1. SKINS -.BR - -.BR -Skins modify the default appearance of document output on a document, -directory, or site wide basis. Skins are looked for in the following locations: - -.BR - \./_sisu/skin - -.BR - ~/.sisu/skin - -.BR - /etc/sisu/skin - -.BR -.B Within the skin directory -are the following the default sub\-directories for document skins: - -.BR - \./skin/doc - -.BR - \./skin/dir - -.BR - \./skin/site - -.BR -A skin is placed in the appropriate directory and the file named skin_[name].rb - -.BR -The skin itself is a ruby file which modifies the default appearances set in -the program. - -.SH -1.1 DOCUMENT SKIN - -.BR -Documents take on a document skin, if the header of the document specifies a -skin to be used. - - -.nf - @skin: skin_united_nations -.fi - -.SH -1.2 DIRECTORY SKIN - -.BR -A directory may be mapped on to a particular skin, so all documents within that -directory take on a particular appearance. If a skin exists in the skin/dir -with the same name as the document directory, it will automatically be used for -each of the documents in that directory, (except where a document specifies the -use of another skin, in the skin/doc directory). - -.BR -A personal habit is to place all skins within the doc directory, and symbolic -links as needed from the site, or dir directories as required. - -.SH -1.3 SITE SKIN - -.BR -A site skin, modifies the program default skin. - -.SH -1.4 SAMPLE SKINS - -.BR -With -.B SiSU -installed sample skins may be found in: - -.BR - /etc/sisu/skin/doc and - /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc - -.BR -(or equivalent directory) and if sisu\-markup\-samples is installed also under: - -.BR - /usr/share/doc/sisu/sisu_markup_samples/non\-free/_sisu/skin/doc - -.BR -Samples of list.yml and promo.yml (which are used to create the right column -list) may be found in: - -.BR - /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml (or equivalent - directory) - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- Skins - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-11\-12 - -.BR -DC Date issued: -.I 2002\-11\-12 - -.BR -DC Date available: -.I 2002\-11\-12 - -.BR -DC Date modified: -.I 2007\-09\-16 - -.BR -DC Date: -.I 2007\-09\-16 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_skin.sst - -.BR -Filetype: -.I SiSU text insert 0.58 - -.BR -Sourcefile Digest, MD5(sisu_skin.sst)= -.I 8aebfb5312045c3a705ad6c314246f67 - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:44 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_skin/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_skin/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_skin/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_skin/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_skin/sisu_skin.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:50 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu |