diff options
Diffstat (limited to 'data/doc/manuals_generated/sisu_manual/sisu_markup/scroll.xhtml')
| -rw-r--r-- | data/doc/manuals_generated/sisu_manual/sisu_markup/scroll.xhtml | 1887 |
1 files changed, 1887 insertions, 0 deletions
diff --git a/data/doc/manuals_generated/sisu_manual/sisu_markup/scroll.xhtml b/data/doc/manuals_generated/sisu_manual/sisu_markup/scroll.xhtml new file mode 100644 index 00000000..869ccc46 --- /dev/null +++ b/data/doc/manuals_generated/sisu_manual/sisu_markup/scroll.xhtml @@ -0,0 +1,1887 @@ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> +<?xml-stylesheet type="text/css" href="../_sisu/css/xhtml.css"?> +<!-- Document processing information: + * Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) + * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] + * + * Last Generated on: Sun Sep 23 04:12:17 +0100 2007 + * SiSU http://www.jus.uio.no/sisu +--> + +<document> +<head> + <meta http-equiv="Content-Type" content="text/html;charset=utf-8" /> + <meta>Title:</meta> + <title class="dc"> + SiSU - Markup [0.58] + </title> + <br /> + <meta>Creator:</meta> + <creator class="dc"> + Ralph Amissah + </creator> + <br /> + <meta>Rights:</meta> + <rights class="dc"> + Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 + </rights> + <br /> + <meta>Type:</meta> + <type class="dc"> + information + </type> + <br /> + <meta>Subject:</meta> + <subject class="dc"> + ebook, epublishing, electronic book, electronic publishing, electronic document, electronic citation, data structure, citation systems, search + </subject> + <br /> + <meta>Date created:</meta> + <date_created class="extra"> + 2002-08-28 + </date_created> + <br /> + <meta>Date issued:</meta> + <date_issued class="extra"> + 2002-08-28 + </date_issued> + <br /> + <meta>Date available:</meta> + <date_available class="extra"> + 2002-08-28 + </date_available> + <br /> + <meta>Date modified:</meta> + <date_modified class="extra"> + 2007-09-16 + </date_modified> + <br /> + <meta>Date:</meta> + <date class="dc"> + 2007-09-16 + </date> + <br /> +</head> +<body> +<object id="1"> + <text class="h1"> + SiSU - Markup [0.58],<br /> Ralph Amissah + </text> + <ocn>1</ocn> +</object> +<object id="2"> + <text class="h2"> + SiSU Markup + </text> + <ocn>2</ocn> +</object> +<object id="3"> + <text class="h4"> + 1. Introduction to SiSU Markup<en>1</en> + </text> + <endnote notenumber="1"> + 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. + </endnote> + <ocn>3</ocn> +</object> +<object id="4"> + <text class="h5"> + 1.1 Summary + </text> + <ocn>4</ocn> +</object> +<object id="5"> + <text class="norm"> + <b>SiSU</b> source documents are plaintext (UTF-8)<en>2</en> files + </text> + <endnote notenumber="2"> + 2. files should be prepared using UTF-8 character encoding + </endnote> + <ocn>5</ocn> +</object> +<object id="6"> + <text class="norm"> + All paragraphs are separated by an empty line. + </text> + <ocn>6</ocn> +</object> +<object id="7"> + <text class="norm"> + Markup is comprised of: + </text> + <ocn>7</ocn> +</object> +<object id="8"> + <text class="indent_bullet"> + 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) + </text> + <ocn>8</ocn> +</object> +<object id="9"> + <text class="indent_bullet"> + 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: + </text> + <ocn>9</ocn> +</object> +<object id="10"> + <text class="indent_bullet1"> + heading levels defines document structure + </text> + <ocn>10</ocn> +</object> +<object id="11"> + <text class="indent_bullet1"> + text basic attributes, italics, bold etc. + </text> + <ocn>11</ocn> +</object> +<object id="12"> + <text class="indent_bullet1"> + grouped text (objects), which are to be treated differently, such +as code blocks or poems. + </text> + <ocn>12</ocn> +</object> +<object id="13"> + <text class="indent_bullet1"> + footnotes/endnotes + </text> + <ocn>13</ocn> +</object> +<object id="14"> + <text class="indent_bullet1"> + linked text and images + </text> + <ocn>14</ocn> +</object> +<object id="15"> + <text class="indent_bullet1"> + paragraph actions, such as indent, bulleted, numbered-lists, etc. + </text> + <ocn>15</ocn> +</object> +<object id="16"> + <text class="norm"> + Some interactive help on markup is available, by typing sisu and +selecting markup or sisu --help markup + </text> + <ocn>16</ocn> +</object> +<object id="17"> + <text class="h5"> + 1.2 Markup Examples + </text> + <ocn>17</ocn> +</object> +<object id="18"> + <text class="h6"> + 1.2.1 Online + </text> + <ocn>18</ocn> +</object> +<object id="19"> + <text class="norm"> + Online markup examples are available together with the respective +outputs produced from <<link +xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" +xlink:href="http://www.jus.uio.no/sisu/SiSU/2.html">http://www.jus.uio.no/sisu/SiSU/2.html</link>> +or from <<link xmlns:xlink="http://www.w3.org/1999/xlink" +xlink:type="simple" +xlink:href="http://www.jus.uio.no/sisu/sisu_examples/">http://www.jus.uio.no/sisu/sisu_examples/</link>> + </text> + <ocn>19</ocn> +</object> +<object id="20"> + <text class="norm"> + There is of course this document, which provides a cursory overview of +sisu markup and the respective output produced: <<link +xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" +xlink:href="http://www.jus.uio.no/sisu/sisu_markup/">http://www.jus.uio.no/sisu/sisu_markup/</link>> + </text> + <ocn>20</ocn> +</object> +<object id="21"> + <text class="norm"> + Some example marked up files are available as html with syntax +highlighting for viewing: <<link +xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" +xlink:href="http://www.jus.uio.no/sisu/sample/syntax">http://www.jus.uio.no/sisu/sample/syntax</link>> + </text> + <ocn>21</ocn> +</object> +<object id="22"> + <text class="norm"> + an alternative presentation of markup syntax: <<link +xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" +xlink:href="http://www.jus.uio.no/sisu/sample/on_markup.txt">http://www.jus.uio.no/sisu/sample/on_markup.txt</link>> + </text> + <ocn>22</ocn> +</object> +<object id="23"> + <text class="h6"> + 1.2.2 Installed + </text> + <ocn>23</ocn> +</object> +<object id="24"> + <text class="norm"> + With <b>SiSU</b> 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 + </text> + <ocn>24</ocn> +</object> +<object id="25"> + <text class="h4"> + 2. Markup of Headers + </text> + <ocn>25</ocn> +</object> +<object id="26"> + <text class="norm"> + 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. + </text> + <ocn>26</ocn> +</object> +<object id="27"> + <text class="norm"> + 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: + </text> + <ocn>27</ocn> +</object> +<object id="28"> + <ocn>28</ocn> + <text class="code"> +    % this would be a comment     + </text> +</object> +<object id="29"> + <text class="h5"> + 2.1 Sample Header + </text> + <ocn>29</ocn> +</object> +<object id="30"> + <text class="norm"> + This current document has a header similar to this one (without the +comments): + </text> + <ocn>30</ocn> +</object> +<object id="31"> + <ocn>31</ocn> + <text class="code"> +    % SiSU 0.57<br /><br />   @title: SiSU<br /><br />   @subtitle: Markup [0.58]<br /><br />   @creator: Ralph Amissah<br /><br />   @rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3<br /><br />   @type: information<br /><br />   @subject: ebook, epublishing, electronic book, electronic publishing, electronic document, electronic citation, data structure, citation systems, search<br /><br />   @date.created: 2002-08-28<br /><br />   @date.issued: 2002-08-28<br /><br />   @date.available: 2002-08-28<br /><br />   @date.modified: 2007-09-16<br /><br />   @date: 2007-09-16<br /><br />   @level: new=C; break=1; num_top=1<br /><br />   % 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).<br /><br />   @skin: skin_sisu_manual<br /><br />   % 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)<br /><br />   @bold: /Gnu|Debian|Ruby|SiSU/<br /><br />   @links: { SiSU Manual }http://www.jus.uio.no/sisu/sisu_manual/ <br />   { Book Samples and Markup Examples }http://www.jus.uio.no/sisu/SiSU/2.html <br />   { SiSU @ Wikipedia }http://en.wikipedia.org/wiki/SiSU <br />   { SiSU @ Freshmeat }http://freshmeat.net/projects/sisu/ <br />   { SiSU @ Ruby Application Archive }http://raa.ruby-lang.org/project/sisu/ <br />   { SiSU @ Debian }http://packages.qa.debian.org/s/sisu.html <br />   { SiSU Download }http://www.jus.uio.no/sisu/SiSU/download.html <br />   { SiSU Changelog }http://www.jus.uio.no/sisu/SiSU/changelog.html<br /> <br />     + </text> +</object> +<object id="32"> + <text class="h5"> + 2.2 Available Headers + </text> + <ocn>32</ocn> +</object> +<object id="33"> + <text class="norm"> + 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 + </text> + <ocn>33</ocn> +</object> +<object id="34"> + <text class="norm"> + <b>@indentifier:</b> information or instructions + </text> + <ocn>34</ocn> +</object> +<object id="35"> + <text class="norm"> + where the "identifier" is a tag recognised by the program, and the +"information" or "instructions" belong to the tag/indentifier specified + </text> + <ocn>35</ocn> +</object> +<object id="36"> + <text class="norm"> + 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. + </text> + <ocn>36</ocn> +</object> +<object id="37"> + <text class="norm"> + This is a sample header + </text> + <ocn>37</ocn> +</object> +<object id="38"> + <text class="norm"> + <b>% SiSU 0.38</b> [declared file-type identifier with markup version] + </text> + <ocn>38</ocn> +</object> +<object id="39"> + <text class="norm"> + <b>@title:</b> [title text] This is the title of the document and used +as such, this header is the only one that is <u>mandatory</u> + </text> + <ocn>39</ocn> +</object> +<object id="40"> + <text class="norm"> + <b>@subtitle:</b> The Subtitle if any + </text> + <ocn>40</ocn> +</object> +<object id="41"> + <text class="norm"> + <b>@creator:</b> [or @author:] Name of Author + </text> + <ocn>41</ocn> +</object> +<object id="42"> + <text class="norm"> + <b>@subject:</b> (whatever your subject) + </text> + <ocn>42</ocn> +</object> +<object id="43"> + <text class="norm"> + <b>@description:</b> + </text> + <ocn>43</ocn> +</object> +<object id="44"> + <text class="norm"> + <b>@publisher:</b> + </text> + <ocn>44</ocn> +</object> +<object id="45"> + <text class="norm"> + <b>@contributor:</b> + </text> + <ocn>45</ocn> +</object> +<object id="46"> + <text class="norm"> + <b>@translator:</b> [or @translated_by:] + </text> + <ocn>46</ocn> +</object> +<object id="47"> + <text class="norm"> + <b>@illustrator:</b> [or @illustrated_by:] + </text> + <ocn>47</ocn> +</object> +<object id="48"> + <text class="norm"> + <b>@prepared_by:</b> [or @digitized_by:] + </text> + <ocn>48</ocn> +</object> +<object id="49"> + <text class="norm"> + <b>@date: 2000-08-27</b> [ also @date.created: @date.issued: +@date.available: @date.valid: @date.modified: ] + </text> + <ocn>49</ocn> +</object> +<object id="50"> + <text class="norm"> + <b>@type: article</b> + </text> + <ocn>50</ocn> +</object> +<object id="51"> + <text class="norm"> + <b>@format:</b> + </text> + <ocn>51</ocn> +</object> +<object id="52"> + <text class="norm"> + <b>@identifier:</b> + </text> + <ocn>52</ocn> +</object> +<object id="53"> + <text class="norm"> + <b>@source:</b> + </text> + <ocn>53</ocn> +</object> +<object id="54"> + <text class="norm"> + <b>@language:</b> [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.] + </text> + <ocn>54</ocn> +</object> +<object id="55"> + <text class="norm"> + [@language.original: original language in which the work was published] + </text> + <ocn>55</ocn> +</object> +<object id="56"> + <text class="norm"> + <b>@papersize:</b> (A4|US_letter|book_B5|book_A5|US_legal) + </text> + <ocn>56</ocn> +</object> +<object id="57"> + <text class="norm"> + <b>@relation:</b> + </text> + <ocn>57</ocn> +</object> +<object id="58"> + <text class="norm"> + <b>@coverage:</b> + </text> + <ocn>58</ocn> +</object> +<object id="59"> + <text class="norm"> + <b>@rights:</b> Copyright (c) Name of Right Holder, all rights +reserved, or as granted: public domain, copyleft, creative commons +variant, etc. + </text> + <ocn>59</ocn> +</object> +<object id="60"> + <text class="norm"> + <b>@owner:</b> + </text> + <ocn>60</ocn> +</object> +<object id="61"> + <text class="norm"> + <b>@keywords:</b> text document generation processing management latex +pdf structured xml citation [your keywords here, used for example by +rss feeds, and in sql searches] + </text> + <ocn>61</ocn> +</object> +<object id="62"> + <text class="norm"> + <b>@abstract:</b> [paper abstract, placed after table of contents] + </text> + <ocn>62</ocn> +</object> +<object id="63"> + <text class="norm"> + <b>@comment:</b> [...] + </text> + <ocn>63</ocn> +</object> +<object id="64"> + <text class="norm"> + <b>@catalogue:</b> loc=[Library of Congress classification]; +dewey=[Dewey classification]; isbn=[ISBN]; pg=[Project Gutenberg text +number] + </text> + <ocn>64</ocn> +</object> +<object id="65"> + <text class="norm"> + <b>@classify_loc:</b> [Library of Congress classification] + </text> + <ocn>65</ocn> +</object> +<object id="66"> + <text class="norm"> + <b>@classify_dewey:</b> [Dewey classification] + </text> + <ocn>66</ocn> +</object> +<object id="67"> + <text class="norm"> + <b>@classify_isbn:</b> [ISBN] + </text> + <ocn>67</ocn> +</object> +<object id="68"> + <text class="norm"> + <b>@classify_pg:</b> [Project Gutenberg text number] + </text> + <ocn>68</ocn> +</object> +<object id="69"> + <text class="norm"> + <b>@prefix:</b> [prefix is placed just after table of contents] + </text> + <ocn>69</ocn> +</object> +<object id="70"> + <text class="norm"> + <b>@prefix_a:</b> [prefix is placed just before table of contents - not +implemented] + </text> + <ocn>70</ocn> +</object> +<object id="71"> + <text class="norm"> + <b>@prefix_b:</b> + </text> + <ocn>71</ocn> +</object> +<object id="72"> + <text class="norm"> + <b>@rcs:</b> $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 ] + </text> + <ocn>72</ocn> +</object> +<object id="73"> + <text class="norm"> + <b>@structure:</b> PART; CHAPTER; SECTION; ARTICLE; none; none;<br /> +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:) + </text> + <ocn>73</ocn> +</object> +<object id="74"> + <text class="norm"> + <b>@level:</b> newpage=3; breakpage=4<br /> [paragraph level, used by +latex to breakpages, the page is optional eg. in newpage] + </text> + <ocn>74</ocn> +</object> +<object id="75"> + <text class="norm"> + <b>@markup:</b> 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.<br /> 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]<br /> 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] + </text> + <ocn>75</ocn> +</object> +<object id="76"> + <text class="norm"> + <b>@bold:</b> [regular expression of words/phrases to be made bold] + </text> + <ocn>76</ocn> +</object> +<object id="77"> + <text class="norm"> + <b>@italics:</b> [regular expression of words/phrases to italicise] + </text> + <ocn>77</ocn> +</object> +<object id="78"> + <text class="norm"> + <b>@vocabulary:</b> name of taxonomy/vocabulary/wordlist to use against +document + </text> + <ocn>78</ocn> +</object> +<object id="79"> + <text class="norm"> + <b>@skin:</b> skin_doc_[name_of_desired_document_skin]<br /> 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. + </text> + <ocn>79</ocn> +</object> +<object id="80"> + <text class="norm"> + <b>@links:</b> { <b>SiSU</b> }http://www.jus.uio.no/sisu/;<br /> +{ FSF }http://www.fsf.org + </text> + <ocn>80</ocn> +</object> +<object id="81"> + <text class="norm"> + <b>@promo:</b> sisu, ruby, search_libre_docs, open_society<br /> +[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] + </text> + <ocn>81</ocn> +</object> +<object id="82"> + <text class="h4"> + 3. Markup of Substantive Text + </text> + <ocn>82</ocn> +</object> +<object id="83"> + <text class="h5"> + 3.1 Heading Levels + </text> + <ocn>83</ocn> +</object> +<object id="84"> + <text class="norm"> + 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) + </text> + <ocn>84</ocn> +</object> +<object id="85"> + <text class="norm"> + <b>:A~ [heading text]</b> 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 + </text> + <ocn>85</ocn> +</object> +<object id="86"> + <text class="norm"> + <b>:B~ [heading text]</b> Second level heading [this is a heading +level divider] + </text> + <ocn>86</ocn> +</object> +<object id="87"> + <text class="norm"> + <b>:C~ [heading text]</b> Third level heading [this is a heading +level divider] + </text> + <ocn>87</ocn> +</object> +<object id="88"> + <text class="norm"> + <b>1~ [heading text]</b> 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 + </text> + <ocn>88</ocn> +</object> +<object id="89"> + <text class="norm"> + <b>2~ [heading text]</b> 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. + </text> + <ocn>89</ocn> +</object> +<object id="90"> + <text class="norm"> + <b>3~ [heading text]</b> 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 + </text> + <ocn>90</ocn> +</object> +<object id="91"> + <ocn>91</ocn> + <text class="code"> +    1~filename level 1 heading,<br /><br />   % 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)     + </text> +</object> +<object id="92"> + <text class="h5"> + 3.2 Font Attributes + </text> + <ocn>92</ocn> +</object> +<object id="93"> + <text class="norm"> + <b>markup example:</b> + </text> + <ocn>93</ocn> +</object> +<object id="94"> + <ocn>94</ocn> + <text class="code"> +    normal text !{emphasis}! *{bold text}* _{underscore}_ /{italics}/ "{citation}" ^{superscript}^ ,{subscript}, +{inserted text}+<br /><br />   normal text<br /><br />   !{emphasis}!<br /><br />   *{bold text}*<br /><br />   _{underscore}<br /><br />   /{italics}/<br /><br />   "{citation}"<br /><br />   ^{superscript}^<br /><br />   ,{subscript},<br /><br />   +{inserted text}+<br /><br />   -{strikethrough}-     + </text> +</object> +<object id="95"> + <text class="norm"> + <b>resulting output:</b> + </text> + <ocn>95</ocn> +</object> +<object id="96"> + <text class="norm"> + normal text <em>emphasis</em> <b>bold text</b> <u>underscore</u> +<i>italics</i> <cite>citation</cite> <sup>superscript</sup> +<sub>subscript</sub> <ins>inserted text</ins> <del>strikethrough</del> + </text> + <ocn>96</ocn> +</object> +<object id="97"> + <text class="norm"> + normal text + </text> + <ocn>97</ocn> +</object> +<object id="98"> + <text class="norm"> + <em>emphasis</em> + </text> + <ocn>98</ocn> +</object> +<object id="99"> + <text class="norm"> + <b>bold text</b> + </text> + <ocn>99</ocn> +</object> +<object id="100"> + <text class="norm"> + <u>underscore</u> + </text> + <ocn>100</ocn> +</object> +<object id="101"> + <text class="norm"> + <i>italics</i> + </text> + <ocn>101</ocn> +</object> +<object id="102"> + <text class="norm"> + <cite>citation</cite> + </text> + <ocn>102</ocn> +</object> +<object id="103"> + <text class="norm"> + <sup>superscript</sup> + </text> + <ocn>103</ocn> +</object> +<object id="104"> + <text class="norm"> + <sub>subscript</sub> + </text> + <ocn>104</ocn> +</object> +<object id="105"> + <text class="norm"> + <ins>inserted text</ins> + </text> + <ocn>105</ocn> +</object> +<object id="106"> + <text class="norm"> + <del>strikethrough</del> + </text> + <ocn>106</ocn> +</object> +<object id="107"> + <text class="h5"> + 3.3 Indentation and bullets + </text> + <ocn>107</ocn> +</object> +<object id="108"> + <text class="norm"> + <b>markup example:</b> + </text> + <ocn>108</ocn> +</object> +<object id="109"> + <ocn>109</ocn> + <text class="code"> +    ordinary paragraph<br /><br />   _1 indent paragraph one step<br /><br />   _2 indent paragraph two steps<br /><br />   _9 indent paragraph nine steps     + </text> +</object> +<object id="110"> + <text class="norm"> + <b>resulting output:</b> + </text> + <ocn>110</ocn> +</object> +<object id="111"> + <text class="norm"> + ordinary paragraph + </text> + <ocn>111</ocn> +</object> +<object id="112"> + <text class="indent1"> + indent paragraph one step + </text> + <ocn>112</ocn> +</object> +<object id="113"> + <text class="indent2"> + indent paragraph two steps + </text> + <ocn>113</ocn> +</object> +<object id="114"> + <text class="indent9"> + indent paragraph nine steps + </text> + <ocn>114</ocn> +</object> +<object id="115"> + <text class="norm"> + <b>markup example:</b> + </text> + <ocn>115</ocn> +</object> +<object id="116"> + <ocn>116</ocn> + <text class="code"> +    _* bullet text<br /><br />   _1* bullet text, first indent<br /><br />   _2* bullet text, two step indent     + </text> +</object> +<object id="117"> + <text class="norm"> + <b>resulting output:</b> + </text> + <ocn>117</ocn> +</object> +<object id="118"> + <text class="indent_bullet"> + bullet text + </text> + <ocn>118</ocn> +</object> +<object id="119"> + <text class="indent_bullet1"> + bullet text, first indent + </text> + <ocn>119</ocn> +</object> +<object id="120"> + <text class="indent_bullet2"> + bullet text, two step indent + </text> + <ocn>120</ocn> +</object> +<object id="121"> + <text class="norm"> + Numbered List (not to be confused with headings/titles, (document +structure)) + </text> + <ocn>121</ocn> +</object> +<object id="122"> + <text class="norm"> + <b>markup example:</b> + </text> + <ocn>122</ocn> +</object> +<object id="123"> + <ocn>123</ocn> + <text class="code"> +    # numbered list numbered list 1., 2., 3, etc.<br /><br />   _# numbered list numbered list indented a., b., c., d., etc.     + </text> +</object> +<object id="124"> + <text class="h5"> + 3.4 Footnotes / Endnotes + </text> + <ocn>124</ocn> +</object> +<object id="125"> + <text class="norm"> + 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. + </text> + <ocn>125</ocn> +</object> +<object id="126"> + <text class="norm"> + <b>markup example:</b> + </text> + <ocn>126</ocn> +</object> +<object id="127"> + <ocn>127</ocn> + <text class="code"> +    ~{ a footnote or endnote }~     + </text> +</object> +<object id="128"> + <text class="norm"> + <b>resulting output:</b> + </text> + <ocn>128</ocn> +</object> +<object id="129"> + <text class="norm"> + <en>3</en> + </text> + <endnote notenumber="3"> + 3. a footnote or endnote + </endnote> + <ocn>129</ocn> +</object> +<object id="130"> + <text class="norm"> + <b>markup example:</b> + </text> + <ocn>130</ocn> +</object> +<object id="131"> + <ocn>131</ocn> + <text class="code"> +    normal text~{ self contained endnote marker & endnote in one }~ continues     + </text> +</object> +<object id="132"> + <text class="norm"> + <b>resulting output:</b> + </text> + <ocn>132</ocn> +</object> +<object id="133"> + <text class="norm"> + normal text<en>4</en> continues + </text> + <endnote notenumber="4"> + 4. self contained endnote marker & endnote in one + </endnote> + <ocn>133</ocn> +</object> +<object id="134"> + <text class="norm"> + <b>markup example:</b> + </text> + <ocn>134</ocn> +</object> +<object id="135"> + <ocn>135</ocn> + <text class="code"> +    normal text ~{* unnumbered asterisk footnote/endnote, insert multiple asterisks if required }~ continues<br /><br />   normal text ~{** another unnumbered asterisk footnote/endnote }~ continues     + </text> +</object> +<object id="136"> + <text class="norm"> + <b>resulting output:</b> + </text> + <ocn>136</ocn> +</object> +<object id="137"> + <text class="norm"> + normal text <en>*</en> continues + </text> + <endnote symbol="*.length"> + * unnumbered asterisk footnote/endnote, insert multiple asterisks if +required + </endnote> + <ocn>137</ocn> +</object> +<object id="138"> + <text class="norm"> + normal text <en>**</en> continues + </text> + <endnote symbol="**.length"> + ** another unnumbered asterisk footnote/endnote + </endnote> + <ocn>138</ocn> +</object> +<object id="139"> + <text class="norm"> + <b>markup example:</b> + </text> + <ocn>139</ocn> +</object> +<object id="140"> + <ocn>140</ocn> + <text class="code"> +    normal text ~[* editors notes, numbered asterisk footnote/endnote series ]~ continues<br /><br />   normal text ~[+ editors notes, numbered asterisk footnote/endnote series ]~ continues     + </text> +</object> +<object id="141"> + <text class="norm"> + <b>resulting output:</b> + </text> + <ocn>141</ocn> +</object> +<object id="142"> + <text class="norm"> + normal text <en>*1</en> continues + </text> + <endnote symbol="*1"> + *1 editors notes, numbered asterisk footnote/endnote series + </endnote> + <ocn>142</ocn> +</object> +<object id="143"> + <text class="norm"> + normal text <en>+1</en> continues + </text> + <endnote symbol="+1"> + +1 editors notes, numbered asterisk footnote/endnote series + </endnote> + <ocn>143</ocn> +</object> +<object id="144"> + <text class="norm"> + <b>Alternative endnote pair notation for footnotes/endnotes:</b> + </text> + <ocn>144</ocn> +</object> +<object id="145"> + <ocn>145</ocn> + <text class="code"> +    % note the endnote marker "~^"<br /><br />   normal text~^ continues<br /><br />   ^~ endnote text following the paragraph in which the marker occurs     + </text> +</object> +<object id="146"> + <text class="norm"> + the standard and pair notation cannot be mixed in the same document + </text> + <ocn>146</ocn> +</object> +<object id="147"> + <text class="h5"> + 3.5 Links + </text> + <ocn>147</ocn> +</object> +<object id="148"> + <text class="h6"> + 3.5.1 Naked URLs within text, dealing with urls + </text> + <ocn>148</ocn> +</object> +<object id="149"> + <text class="norm"> + 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). + </text> + <ocn>149</ocn> +</object> +<object id="150"> + <text class="norm"> + <b>markup example:</b> + </text> + <ocn>150</ocn> +</object> +<object id="151"> + <ocn>151</ocn> + <text class="code"> +    normal text http://www.jus.uio.no/sisu continues     + </text> +</object> +<object id="152"> + <text class="norm"> + <b>resulting output:</b> + </text> + <ocn>152</ocn> +</object> +<object id="153"> + <text class="norm"> + normal text <<link xmlns:xlink="http://www.w3.org/1999/xlink" +xlink:type="simple" +xlink:href="http://www.jus.uio.no/sisu">http://www.jus.uio.no/sisu</link>> +continues + </text> + <ocn>153</ocn> +</object> +<object id="154"> + <text class="norm"> + An escaped url without decoration + </text> + <ocn>154</ocn> +</object> +<object id="155"> + <text class="norm"> + <b>markup example:</b> + </text> + <ocn>155</ocn> +</object> +<object id="156"> + <ocn>156</ocn> + <text class="code"> +    normal text _http://www.jus.uio.no/sisu continues<br /><br />   deb _http://www.jus.uio.no/sisu/archive unstable main non-free     + </text> +</object> +<object id="157"> + <text class="norm"> + <b>resulting output:</b> + </text> + <ocn>157</ocn> +</object> +<object id="158"> + <text class="norm"> + normal text <link xmlns:xlink="http://www.w3.org/1999/xlink" +xlink:type="simple" +xlink:href="http://www.jus.uio.no/sisu">http://www.jus.uio.no/sisu</link> +continues + </text> + <ocn>158</ocn> +</object> +<object id="159"> + <text class="norm"> + deb <link xmlns:xlink="http://www.w3.org/1999/xlink" +xlink:type="simple" +xlink:href="http://www.jus.uio.no/sisu/archive">http://www.jus.uio.no/sisu/archive</link> +unstable main non-free + </text> + <ocn>159</ocn> +</object> +<object id="160"> + <text class="norm"> + where a code block is used there is neither decoration nor +hyperlinking, code blocks are discussed later in this document + </text> + <ocn>160</ocn> +</object> +<object id="161"> + <text class="norm"> + <b>resulting output:</b> + </text> + <ocn>161</ocn> +</object> +<object id="162"> + <ocn>162</ocn> + <text class="code"> +    deb http://www.jus.uio.no/sisu/archive unstable main non-free<br />   deb-src http://www.jus.uio.no/sisu/archive unstable main non-free     + </text> +</object> +<object id="163"> + <text class="norm"> + To link text or an image to a url the markup is as follows + </text> + <ocn>163</ocn> +</object> +<object id="164"> + <text class="norm"> + <b>markup example:</b> + </text> + <ocn>164</ocn> +</object> +<object id="165"> + <ocn>165</ocn> + <text class="code"> +    about { SiSU }http://url.org markup     + </text> +</object> +<object id="166"> + <text class="h6"> + 3.5.2 Linking Text + </text> + <ocn>166</ocn> +</object> +<object id="167"> + <text class="norm"> + <b>resulting output:</b> + </text> + <ocn>167</ocn> +</object> +<object id="168"> + <text class="norm"> + about <link xmlns:xlink="http://www.w3.org/1999/xlink" +xlink:type="simple" xlink:href="http://www.jus.uio.no/sisu/"> SiSU +</link> markup + </text> + <ocn>168</ocn> +</object> +<object id="169"> + <text class="norm"> + A shortcut notation is available so the url link may also be provided +automatically as a footnote + </text> + <ocn>169</ocn> +</object> +<object id="170"> + <text class="norm"> + <b>markup example:</b> + </text> + <ocn>170</ocn> +</object> +<object id="171"> + <ocn>171</ocn> + <text class="code"> +    about {~^ SiSU }http://url.org markup     + </text> +</object> +<object id="172"> + <text class="norm"> + <b>resulting output:</b> + </text> + <ocn>172</ocn> +</object> +<object id="173"> + <text class="norm"> + about <link xmlns:xlink="http://www.w3.org/1999/xlink" +xlink:type="simple" xlink:href="http://www.jus.uio.no/sisu/"> SiSU +</link> <en>5</en> markup + </text> + <endnote notenumber="5"> + 5. <<link xmlns:xlink="http://www.w3.org/1999/xlink" +xlink:type="simple" +xlink:href="http://www.jus.uio.no/sisu/">http://www.jus.uio.no/sisu/</link>> + </endnote> + <ocn>173</ocn> +</object> +<object id="174"> + <text class="h6"> + 3.5.3 Linking Images + </text> + <ocn>174</ocn> +</object> +<object id="175"> + <text class="norm"> + <b>markup example:</b> + </text> + <ocn>175</ocn> +</object> +<object id="176"> + <ocn>176</ocn> + <text class="code"> +    {tux.png 64x80 }image<br /><br />   % various url linked images<br /><br />   {tux.png 64x80 "a better way" }http://www.jus.uio.no/sisu/<br /> <br />   {GnuDebianLinuxRubyBetterWay.png 100x101 "Way Better - with Gnu/Linux, Debian and Ruby" }http://www.jus.uio.no/sisu/<br /> <br />   {~^ ruby_logo.png "Ruby" }http://www.ruby-lang.org/en/<br /> <br />     + </text> +</object> +<object id="177"> + <text class="norm"> + <b>resulting output:</b> + </text> + <ocn>177</ocn> +</object> +<object id="178"> + <text class="norm"> + {tux.png 64x80 }image + </text> + <ocn>178</ocn> +</object> +<object id="179"> + <text class="norm"> + <image xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" +xlink:actuate="onLoad" xlink:show="embed" +xlink:href="../_sisu/image_local/tux.png" width="64" height="80" +/>[tux.png] "Gnu/Linux - a better way" + </text> + <ocn>179</ocn> +</object> +<object id="180"> + <text class="norm"> + [ ruby_logo (png missing) ] <en>6</en> + </text> + <endnote notenumber="6"> + 6. <<link xmlns:xlink="http://www.w3.org/1999/xlink" +xlink:type="simple" +xlink:href="http://www.ruby-lang.org/en/">http://www.ruby-lang.org/en/</link>> + </endnote> + <ocn>180</ocn> +</object> +<object id="181"> + <text class="norm"> + <image xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" +xlink:actuate="onLoad" xlink:show="embed" +xlink:href="../_sisu/image_local/GnuDebianLinuxRubyBetterWay.png" +width="100" height="101" />[GnuDebianLinuxRubyBetterWay.png] "Way +Better - with Gnu/Linux, Debian and Ruby" + </text> + <ocn>181</ocn> +</object> +<object id="182"> + <text class="norm"> + <b>linked url footnote shortcut</b> + </text> + <ocn>182</ocn> +</object> +<object id="183"> + <ocn>183</ocn> + <text class="code"> +    {~^ [text to link] }http://url.org<br /> <br />   % maps to: { [text to link] }http://url.org ~{ http://url.org }~<br /><br />   % which produces hyper-linked text within a document/paragraph, with an endnote providing the url for the text location used in the hyperlink     + </text> +</object> +<object id="184"> + <ocn>184</ocn> + <text class="code"> +    text marker *~name     + </text> +</object> +<object id="185"> + <text class="norm"> + 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. + </text> + <ocn>185</ocn> +</object> +<object id="186"> + <text class="h5"> + 3.6 Grouped Text + </text> + <ocn>186</ocn> +</object> +<object id="187"> + <text class="h6"> + 3.6.1 Tables + </text> + <ocn>187</ocn> +</object> +<object id="188"> + <text class="norm"> + Tables may be prepared in two either of two forms + </text> + <ocn>188</ocn> +</object> +<object id="189"> + <text class="norm"> + <b>markup example:</b> + </text> + <ocn>189</ocn> +</object> +<object id="190"> + <ocn>190</ocn> + <text class="code"> +    table{ c3; 40; 30; 30;<br /><br />   This is a table<br />   this would become column two of row one<br />   column three of row one is here<br /><br />   And here begins another row<br />   column two of row two<br />   column three of row two, and so on<br /><br />   }table     + </text> +</object> +<object id="191"> + <text class="norm"> + <b>resulting output:</b> + </text> + <ocn>191</ocn> +</object> +<object id="192"> + +<ocn></ocn><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> + <tr> + <td width="40%" valign="top"> + This is a table + </td> + <td width="30%" valign="top"> + this would become column two of row one + </td> + <td width="30%" valign="top"> + column three of row one is here +</td> +</tr> + + <tr> + <td width="40%" valign="top"> + And here begins another row + </td> + <td width="30%" valign="top"> + column two of row two + </td> + <td width="30%" valign="top"> + column three of row two, and so on +</td> +</tr> + + </table> +</object> +<object id="193"> + <text class="norm"> + a second form may be easier to work with in cases where there is not +much information in each column + </text> + <ocn>193</ocn> +</object> +<object id="194"> + <text class="norm"> + <b>markup example:</b><en>7</en> + </text> + <endnote notenumber="7"> + 7. Table from the Wealth of Networks by Yochai Benkler<br /> <<link +xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" +xlink:href="http://www.jus.uio.no/sisu/the_wealth_of_networks.yochai_benkler">http://www.jus.uio.no/sisu/the_wealth_of_networks.yochai_benkler</link>> + </endnote> + <ocn>194</ocn> +</object> +<object id="195"> + <ocn>195</ocn> + <text class="code"> +    !_ Table 3.1: Contributors to Wikipedia, January 2001 - June 2005<br /><br />   {table~h 24; 12; 12; 12; 12; 12; 12;}<br />   |Jan. 2001|Jan. 2002|Jan. 2003|Jan. 2004|July 2004|June 2006<br />   Contributors* | 10| 472| 2,188| 9,653| 25,011| 48,721<br />   Active contributors** | 9| 212| 846| 3,228| 8,442| 16,945<br />   Very active contributors*** | 0| 31| 190| 692| 1,639| 3,016<br />   No. of English language articles| 25| 16,000| 101,000| 190,000| 320,000| 630,000<br />   No. of articles, all languages | 25| 19,000| 138,000| 490,000| 862,000|1,600,000<br /><br />   \* Contributed at least ten times; \** at least 5 times in last month; \*\** more than 100 times in last month.     + </text> +</object> +<object id="196"> + <text class="norm"> + <b>resulting output:</b> + </text> + <ocn>196</ocn> +</object> +<object id="197"> + <text class="norm"> + <b>Table 3.1: Contributors to Wikipedia, January 2001 - June 2005</b> + </text> + <ocn>197</ocn> +</object> +<object id="198"> + +<ocn></ocn><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> + <tr> + <td width="24%" valign="top"> + <b> </b></td><td width="12%" valign="top"> + <b>Jan. 2001</b></td><td width="12%" valign="top"> + <b>Jan. 2002</b></td><td width="12%" valign="top"> + <b>Jan. 2003</b></td><td width="12%" valign="top"> + <b>Jan. 2004</b></td><td width="12%" valign="top"> + <b>July 2004</b></td><td width="12%" valign="top"> + <b>June 2006</b> +</td> +</tr> + <tr> + <td width="24%" valign="top"> + Contributors* + </td> + <td width="12%" valign="top"> + 10 + </td> + <td width="12%" valign="top"> + 472 + </td> + <td width="12%" valign="top"> + 2,188 + </td> + <td width="12%" valign="top"> + 9,653 + </td> + <td width="12%" valign="top"> + 25,011 + </td> + <td width="12%" valign="top"> + 48,721 +</td> +</tr> + + <tr> + <td width="24%" valign="top"> + Active contributors** + </td> + <td width="12%" valign="top"> + 9 + </td> + <td width="12%" valign="top"> + 212 + </td> + <td width="12%" valign="top"> + 846 + </td> + <td width="12%" valign="top"> + 3,228 + </td> + <td width="12%" valign="top"> + 8,442 + </td> + <td width="12%" valign="top"> + 16,945 +</td> +</tr> + + <tr> + <td width="24%" valign="top"> + Very active contributors*** + </td> + <td width="12%" valign="top"> + 0 + </td> + <td width="12%" valign="top"> + 31 + </td> + <td width="12%" valign="top"> + 190 + </td> + <td width="12%" valign="top"> + 692 + </td> + <td width="12%" valign="top"> + 1,639 + </td> + <td width="12%" valign="top"> + 3,016 +</td> +</tr> + + <tr> + <td width="24%" valign="top"> + No. of English language articles + </td> + <td width="12%" valign="top"> + 25 + </td> + <td width="12%" valign="top"> + 16,000 + </td> + <td width="12%" valign="top"> + 101,000 + </td> + <td width="12%" valign="top"> + 190,000 + </td> + <td width="12%" valign="top"> + 320,000 + </td> + <td width="12%" valign="top"> + 630,000 +</td> +</tr> + + <tr> + <td width="24%" valign="top"> + No. of articles, all languages + </td> + <td width="12%" valign="top"> + 25 + </td> + <td width="12%" valign="top"> + 19,000 + </td> + <td width="12%" valign="top"> + 138,000 + </td> + <td width="12%" valign="top"> + 490,000 + </td> + <td width="12%" valign="top"> + 862,000 + </td> + <td width="12%" valign="top"> + 1,600,000 +</td> +</tr> + + </table> +</object> +<object id="199"> + <text class="norm"> + * Contributed at least ten times; ** at least 5 times in last +month; *** more than 100 times in last month. + </text> + <ocn>199</ocn> +</object> +<object id="200"> + <text class="h6"> + 3.6.2 Poem + </text> + <ocn>200</ocn> +</object> +<object id="201"> + <text class="norm"> + <b>basic markup:</b> + </text> + <ocn>201</ocn> +</object> +<object id="202"> + <ocn>202</ocn> + <text class="code"> +    poem{<br /><br />   Your poem here<br /><br />   }poem<br /><br />   Each verse in a poem is given a separate object number.     + </text> +</object> +<object id="203"> + <text class="norm"> + <b>markup example:</b> + </text> + <ocn>203</ocn> +</object> +<object id="204"> + <ocn>204</ocn> + <text class="code"> +    poem{<br /><br />   'Fury said to a<br />   mouse, That he<br />   met in the<br />   house,<br />   "Let us<br />   both go to<br />   law: I will<br />   prosecute<br />   YOU. --Come,<br />   I'll take no<br />   denial; We<br />   must have a<br />   trial: For<br />   really this<br />   morning I've<br />   nothing<br />   to do."<br />   Said the<br />   mouse to the<br />   cur, "Such<br />   a trial,<br />   dear Sir,<br />   With<br />   no jury<br />   or judge,<br />   would be<br />   wasting<br />   our<br />   breath."<br />   "I'll be<br />   judge, I'll<br />   be jury,"<br />   Said<br />   cunning<br />   old Fury:<br />   "I'll<br />   try the<br />   whole<br />   cause,<br />   and<br />   condemn<br />   you<br />   to<br />   death."'<br /><br />   }poem     + </text> +</object> +<object id="205"> + <text class="norm"> + <b>resulting output:</b> + </text> + <ocn>205</ocn> +</object> +<object id="206"> + <ocn>206</ocn> + <text class="verse"> + 'Fury said to a<br /> mouse, That he<br /> met in the<br /> house,<br /> "Let us<br /> both go to<br /> law: I will<br /> prosecute<br /> YOU. --Come,<br /> I'll take no<br /> denial; We<br /> must have a<br /> trial: For<br /> really this<br /> morning I've<br /> nothing<br /> to do."<br /> Said the<br /> mouse to the<br /> cur, "Such<br /> a trial,<br /> dear Sir,<br /> With<br /> no jury<br /> or judge,<br /> would be<br /> wasting<br /> our<br /> breath."<br /> "I'll be<br /> judge, I'll<br /> be jury,"<br /> Said<br /> cunning<br /> old Fury:<br /> "I'll<br /> try the<br /> whole<br /> cause,<br /> and<br /> condemn<br /> you<br /> to<br /> death."'<br /> + </text> +</object> +<object id="207"> + <text class="h6"> + 3.6.3 Group + </text> + <ocn>207</ocn> +</object> +<object id="208"> + <text class="norm"> + <b>basic markup:</b> + </text> + <ocn>208</ocn> +</object> +<object id="209"> + <ocn>209</ocn> + <text class="code"> +    group{<br /><br />   Your grouped text here<br /><br />   }group<br /><br />   A group is treated as an object and given a single object number.     + </text> +</object> +<object id="210"> + <text class="norm"> + <b>markup example:</b> + </text> + <ocn>210</ocn> +</object> +<object id="211"> + <ocn>211</ocn> + <text class="code"> +    group{<br /><br />   'Fury said to a<br />   mouse, That he<br />   met in the<br />   house,<br />   "Let us<br />   both go to<br />   law: I will<br />   prosecute<br />   YOU. --Come,<br />   I'll take no<br />   denial; We<br />   must have a<br />   trial: For<br />   really this<br />   morning I've<br />   nothing<br />   to do."<br />   Said the<br />   mouse to the<br />   cur, "Such<br />   a trial,<br />   dear Sir,<br />   With<br />   no jury<br />   or judge,<br />   would be<br />   wasting<br />   our<br />   breath."<br />   "I'll be<br />   judge, I'll<br />   be jury,"<br />   Said<br />   cunning<br />   old Fury:<br />   "I'll<br />   try the<br />   whole<br />   cause,<br />   and<br />   condemn<br />   you<br />   to<br />   death."'<br /><br />   }group     + </text> +</object> +<object id="212"> + <text class="norm"> + <b>resulting output:</b> + </text> + <ocn>212</ocn> +</object> +<object id="213"> + <ocn>213</ocn> + <text class="group"> + 'Fury said to a<br /> mouse, That he<br /> met in the<br /> house,<br /> "Let us<br /> both go to<br /> law: I will<br /> prosecute<br /> YOU. --Come,<br /> I'll take no<br /> denial; We<br /> must have a<br /> trial: For<br /> really this<br /> morning I've<br /> nothing<br /> to do."<br /> Said the<br /> mouse to the<br /> cur, "Such<br /> a trial,<br /> dear Sir,<br /> With<br /> no jury<br /> or judge,<br /> would be<br /> wasting<br /> our<br /> breath."<br /> "I'll be<br /> judge, I'll<br /> be jury,"<br /> Said<br /> cunning<br /> old Fury:<br /> "I'll<br /> try the<br /> whole<br /> cause,<br /> and<br /> condemn<br /> you<br /> to<br /> death."'<br /> + </text> +</object> +<object id="214"> + <text class="h6"> + 3.6.4 Code + </text> + <ocn>214</ocn> +</object> +<object id="215"> + <text class="norm"> + Code tags are used to escape regular sisu markup, and have been used +extensively within this document to provide examples of <b>SiSU</b> +markup. You cannot however use code tags to escape code tags. They are +however used in the same way as group or poem tags. + </text> + <ocn>215</ocn> +</object> +<object id="216"> + <text class="norm"> + 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] + </text> + <ocn>216</ocn> +</object> +<object id="217"> + <text class="norm"> + <b>use of code tags instead of poem compared, resulting output:</b> + </text> + <ocn>217</ocn> +</object> +<object id="218"> + <ocn>218</ocn> + <text class="code"> +    'Fury said to a<br />   mouse, That he<br />   met in the<br />   house,<br />   "Let us<br />   both go to<br />   law: I will<br />   prosecute<br />   YOU. --Come,<br />   I'll take no<br />   denial; We<br />   must have a<br />   trial: For<br />   really this<br />   morning I've<br />   nothing<br />   to do."<br />   Said the<br />   mouse to the<br />   cur, "Such<br />   a trial,<br />   dear Sir,<br />   With<br />   no jury<br />   or judge,<br />   would be<br />   wasting<br />   our<br />   breath."<br />   "I'll be<br />   judge, I'll<br />   be jury,"<br />   Said<br />   cunning<br />   old Fury:<br />   "I'll<br />   try the<br />   whole<br />   cause,<br />   and<br />   condemn<br />   you<br />   to<br />   death."'     + </text> +</object> +<object id="219"> + <text class="h4"> + 4. Composite documents markup + </text> + <ocn>219</ocn> +</object> +<object id="220"> + <text class="norm"> + 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</b> 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</b> +regular markup file, or <b>.ssi</b> (insert/information) A secondary +file of the composite document is built prior to processing with the +same prefix and the suffix <b>._sst</b> + </text> + <ocn>220</ocn> +</object> +<object id="221"> + <text class="norm"> + basic markup for importing a document into a master document + </text> + <ocn>221</ocn> +</object> +<object id="222"> + <ocn>222</ocn> + <text class="code"> +    << |filename1.sst|@|^|<br /><br />   << |filename2.ssi|@|^|     + </text> +</object> +<object id="223"> + <text class="norm"> + 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. + </text> + <ocn>223</ocn> +</object> +<object id="224"> + <ocn>224</ocn> + <text class="code"> +    r{filename}<br /><br />   {filename.ssi}require<br /><br />   << {filename.ssi}<br /><br />   % using textlink alternatives<br /><br />   |filename.ssi|@|^|require<br /><br />   << |filename.ssi|@|^|<br /><br />   % using thlnk alternatives<br /><br />   <url:filename.ssi>require<br /><br />   << <url:filename.ssi>     + </text> +</object> +<object id="225"> + <text class="h3"> + Markup Syntax History + </text> + <ocn>225</ocn> +</object> +<object id="226"> + <text class="h4"> + 5. Notes related to Files-types and Markup Syntax + </text> + <ocn>226</ocn> +</object> +<object id="227"> + <text class="norm"> + 0.38 is substantially current, depreciated 0.16 supported, though file +names were changed at 0.37 + </text> + <ocn>227</ocn> +</object> +<object id="228"> + <text class="norm"> + <b>0.52</b> (2007w14/6) declared document type identifier at start of +text/document: + </text> + <ocn>228</ocn> +</object> +<object id="229"> + <text class="indent1"> + <b>SiSU</b> 0.52 + </text> + <ocn>229</ocn> +</object> +<object id="230"> + <text class="norm"> + or, backward compatible using the comment marker: + </text> + <ocn>230</ocn> +</object> +<object id="231"> + <text class="indent1"> + % <b>SiSU</b> 0.38 + </text> + <ocn>231</ocn> +</object> +<object id="232"> + <text class="norm"> + variations include '<b>SiSU</b> (text|master|insert) [version]' and +'sisu-[version]' + </text> + <ocn>232</ocn> +</object> +<object id="233"> + <text class="norm"> + <b>0.51</b> (2007w13/6) skins changed (simplified), markup unchanged + </text> + <ocn>233</ocn> +</object> +<object id="234"> + <text class="norm"> + <b>0.42</b> (2006w27/4) * (asterisk) type endnotes, used e.g. in +relation to author + </text> + <ocn>234</ocn> +</object> +<object id="235"> + <text class="norm"> + <b>0.38</b> (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) + </text> + <ocn>235</ocn> +</object> +<object id="236"> + <text class="norm"> + <b>0.37</b> (2006w09/7) introduced new file naming convention, .sst +(text), .ssm (master), .ssi (insert), markup syntax unchanged + </text> + <ocn>236</ocn> +</object> +<object id="237"> + <text class="norm"> + <b>0.35</b> (2005w52/3) sisupod, zipped content file introduced + </text> + <ocn>237</ocn> +</object> +<object id="238"> + <text class="norm"> + <b>0.23</b> (2005w36/2) utf-8 for markup file + </text> + <ocn>238</ocn> +</object> +<object id="239"> + <text class="norm"> + <b>0.22</b> (2005w35/3) image dimensions may be omitted if rmagick is +available to be relied upon + </text> + <ocn>239</ocn> +</object> +<object id="240"> + <text class="norm"> + <b>0.20.4</b> (2005w33/4) header 0~links + </text> + <ocn>240</ocn> +</object> +<object id="241"> + <text class="norm"> + <b>0.16</b> (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 + </text> + <ocn>241</ocn> +</object> +<object id="0"> + <text class="h4"> + Endnotes + </text> + <ocn>0</ocn> +</object> +</body> +</document> |