From 50d45c6deb0afd2e4222d2e33a45487a9d1fa676 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Sun, 23 Sep 2007 05:16:21 +0100 Subject: primarily todo with sisu documentation, changelog reproduced below: * start documenting sisu using sisu * sisu markup source files in data/doc/sisu/sisu_markup_samples/sisu_manual/ /usr/share/doc/sisu/sisu_markup_samples/sisu_manual/ * default output [sisu -3] in data/doc/manuals_generated/sisu_manual/ /usr/share/doc/manuals_generated/sisu_manual/ (adds substantially to the size of sisu package!) * help related edits * manpage, work on ability to generate manpages, improved * param, exclude footnote mark count when occurs within code block * plaintext changes made * shared_txt, line wrap visited * file:// link option introduced (in addition to existing https?:// and ftp://) a bit arbitrarily, diff here, [double check changes in sysenv and hub] * minor adjustments * html url match refinement * css added tiny_center * plaintext * endnotes fix * footnote adjustment to make more easily distinguishable from substantive text * flag -a only [flags -A -e -E dropped] controlled by modifiers --unix/msdos --footnote/endnote * defaults, homepage * renamed homepage (instead of index) implications for modifying skins, which need likewise to have any homepage entry renamed * added link to sisu_manual in homepage * css the css for the default homepage is renamed homepage.css (instead of index.css) [consider removing this and relying on html.css] * ruby version < ruby1.9 * place stop on installation and working with for now [ruby String.strip broken in ruby 1.9.0 (2007-09-10 patchlevel 0) [i486-linux], 2007-09-18:38/2] * debian/control restrict use to ruby > 1.8.4 and ruby < 1.9 * debian * debian/control restrict use to ruby > 1.8.4 and ruby < 1.9 * sisu-doc new sub-package for sisu documentation debian/control and sisu-doc.install --- .../sisu_markup_samples/sisu_manual/sisu_pdf.sst | 100 +++++++++++++++++++++ 1 file changed, 100 insertions(+) create mode 100644 data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_pdf.sst (limited to 'data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_pdf.sst') diff --git a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_pdf.sst b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_pdf.sst new file mode 100644 index 00000000..8e54160c --- /dev/null +++ b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_pdf.sst @@ -0,0 +1,100 @@ +% SiSU 0.58 + +@title: SiSU - SiSU information Structuring Universe + +@subtitle: Search [0.58] + +@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 + +@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/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 +{ 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 Search + +:C~ SiSU Sqlite + +1~sqlite Sqlite + +2~ Name + +SiSU - Structured information, Serialized Units - a document publishing system. + +2~ Description + +Information creating pdf output with sisu (and related to the sisu_pdf dependency package, which is a dummy package to install dependencies needed for SiSU to generate pdfs (primarily related to LaTeX), sisu_pdf being part of SiSU - man sisu). + +SiSU generates LaTeX which is converted by LaTeX tools to pdf. + +2~ Synopsis + +_1 sisu -pv [filename/wildcard] + +2~ Commands + +!_ sisu -pv [filename/wildcard]
+creates two pdf documents: vertical (portrait.pdf) and; horizontal (landscape.pdf). SiSU generates LaTeX output which is converted to pdf if the appropriate LaTeX dependencies are met on the system. + +!_ sisu -pv --papersize-a4 [filename/wildcard]
+overrides the default papersize set to A4. Preset alternative sizes include: 'A4', U.S. 'letter' and 'legal' and book sizes 'A5' and 'B5' (system defaults to A4). + +2~ Setting Paper Size + +The paper-size may be set to any of the following sizes: 'A4', U.S. 'letter' and 'legal' and book sizes: 'A5' and 'B5' + +# The preset default if not otherwise given in the configuration file or elsewhere is A4. + +# The default paper size may be set in the configuration file sisurc.yml. See sisu_configuration: + +code{ + +#% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal + +default: + papersize: 'A4' + +}code + +# Paper size may be set in a document header: + +code{ + +@papersize: (A4|US_letter|book_B5|book_A5|US_legal) + +}code + +# or provided with additional command line parameter, e.g. + +_1 sisu -pv --papersize-a4 [filename/wildcard] + -- cgit v1.2.3