1.1   Hvordan installere nødvendig programvare På UiO:

For å generere ei html-fil må du ha noen biter installert på maskinen din:

$ cat /etc/usit/sw-localcopy
..
docutils
python

maskin# /local/etc/config/store/store.nightly

De to pakkene kan du installere f.eks med

storeapp -a docutils
storeapp -a python

så kan du kjøre /local/bin/rst2html.py på fila og redirigere til fil, f.eks slik:

$ rst2html.py rst-mal.rst > rst-mal.html

Det er også mulig å få laget ei latex-fil for f.eks å generere .ps-fil eller .pdf-fil senere. med rst2latex.

Du finner et godt dokument i rST på http://intra.usit.uio.no/gt/postmaster/systemdok.rst

2.1   Avsnitt og lister

Her er et avsnitt. Det er skilt fra det neste med ei blank linje.

NB! Uten blanke linjer får du heller ikke linjeskift jf. http://folk.uio.no/kjell/rst-mal.html#det-som-ikke-er-anbefalt-eller-mulig

Under her lager jeg ei liste i to nivå. Merk den tomme linja etter første punkt og før lista:

• punkt A i en liste
  • 1. Ei underliste, punkt 1 - 2. punkt 2
• punkt B punkt C

2.2   Uthevet skrift

Skal du ha noe i kursiv eller sterkt uthevet?

2.3   Skrive spesialtegn

Å skrive stjerner (asterisk) kan gjøres med /usit/modell/*

2.4   Bilder

For å legge inn et bilde bruker du de magiske to punktum og kaller det med ordet image:

2.5   <pre>

1. To kolon

   Preformatert tekst med magikken med to kolon her

   Dette er preformatert tekst.
   
   Den er indentert også og fortsetter helt ut avsnittet.
   

   Her er det slutt.

2. Doble quotes-tegn for hver linje:

   Trenger du å skrive noe på en spesiell måte kan du det med doble quotes.

   Du må gjenta for hver linje da linjeskift ikke vil klare seg.

3. Ved inntrykk i teksten

   Trolig er det mye lettere både å skrive og å lese tekst som er indentert i teksten slik.

   Dette brukes mye for sitater ol.

   Kommentar: Dersom du bruker emacs er det to kjekke funksjoner for å få til disse innrykkene i teksten. Det er:

   • ^ r t <et knippe blanke>
   • M-x fill-individual-paragraphs som virker på ei lang linje med et knippe blanke i starten av linja.

2.6   Fotnoter

Fotnoter[1] kommer med i html-dokumentet om de har de magiske to punktumene nederst, i kallet.

Det er også mulig med autonummererte fotnoter, se http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#auto-numbered-footnotes

Tester auto_fotnote [2] da de kan mikses. Her er nok [3] en fotnote. De automatiske får superscript i teksten, mens de manuelle kommer i firkant-parenteser.

2.7   Tabeller

Her er et eksempel på en tabell:

2.8   Navngitte URLer uten adresse

Vil du ha en peker slik at URLen er skjult og kun navnet/referanse kommer i teksten. Kan du gjøre det med sitert tekst avsluttet med en underline.

Her er et forsøk: Kjells hjemmeside

2.9   Ikke klikkbar (anonym?) peker

Dersom du kun vil ha en http://folk.uio.no/kjell/ peker som IKKE er klikkbar må det gjøres slik: Med en underline foran pekeren som står i sitat-tegn

3.1   Referanser

Q: Hva er disse referanser for noe?

A: Trolig bare en peker ned i dokumentet.

De virker greit opp i innholdsfortegnelsen også.

4.1   Kun linjeskift

Dersom det er et linjeskift og ikke et avsnitt er det ikke lett.

Fra the reStructuredText Markup Specification:

"If the preservation of line breaks and/or other whitespace is important, literal blocks should be used"