kontrakurs.org/.navodila.mdwn

221 lines
5.6 KiB
Markdown

[[!meta title="Navodila"]]
*kontrakurs.org* je *wiki*, postopen in neusmerjen sistem medsebojno
povezanih prispevkov različnih avtorjev in avtoric. Na tej strani so
opisana navodila za uporabo, ustvarjanje in urejanje prispevkov.
[[!toc levels=2]]
# Ustvarjanje prispevkov z "wikilinki"
Wiki je mreža prispevkov. Nov prispevek je najenostavneje in najbolj
smiselno ustvariti tako, da se na še neobstoječo stran prispevka
navežemo iz neke že obstoječe strani. To storimo tako, da med urejanjem
obstoječe strani uporabimo ime še neobstoječe strani *znotraj dvojnih
oglatih oklepajev*: [[navodila/primer]].
"Koda" prejšnjega stavka izgleda tako:
```
To storimo tako, da med urejanjem obstoječe strani uporabimo ime še
neobstoječe strani *znotraj dvojnih oglatih oklepajev*:
\[[navodila/primer]].
```
S tem ustvarimo tako imenovani "wikilink". V primeru, da stran še ne
obstaja, se ti oglati oklepaji pretvorijo v povezavo do ustvarjanja nove
strani. Ko že obstaja, pa se pretvori v povezavo do strani.
## Ustvarjanje podstrani z "wikilinki"
## Prikazno besedilo povezave
## Povezava do dela strani
Glej tudi:
- A
- B
- C
# Urejanje strani v markdown formatu
Besedila na tem *wikiju* se pišejo v formatu, ki se imenuje *markdown*.
Gre za enostaven in dokaj nedvoumen način označevanja delov besedila. Na
tej strani je opisan okrnjen nabor pravil izvorne specifikacije
*markdowna* in nekaj dodatnih pravil *ikiwiki* različice *markdowna*. Za
celotna navodila se posvetujte z [Markdown:
Syntax](https://daringfireball.net/projects/markdown/) ali [Formatting
wiki pages](https://ikiwiki.info/ikiwiki/formatting/).
## Odstavki
Med odstavki puščajte prazno vrstico.
```
Besedila na tem *wikiju* se pišejo v formatu, ki se imenuje *markdown*.
Med odstavki puščajte prazno vrstico.
```
## Poudarki
Besedilo lahko *poudarite ležeče* tako, da ga postavite med zvezdici.
```
Besedilo lahko *poudarite ležeče* tako, da ga postavite med zvezdici.
```
\# Naslovi
Naslove označite z `#`. Število `#` določa raven naslova.
\## Podnaslov
\### Podpodnaslov
```
# Markdown osnove
Naslov označite z `#`. Število `#` določa raven naslova.
## Podnaslov
### Podpodnaslov
```
## Citati
Daljšim citatom dodajte `>`. Tako na primer Manfredo Tafuri:
> tako kot ne more obstajati razredna Politična ekonomija,
ampak samo razredna kritika Politične ekonomije, tako se ne more
utemeljiti razredne estetike, umetnosti, arhitekture, ampak samo
razredno kritiko estetike, umetnosti, arhitekture, mesta.
```
Daljšim citatom dodajte `>`. Tako na primer Manfredo Tafuri:
> tako kot ne more obstajati razredna Politična ekonomija,
ampak samo razredna kritika Politične ekonomije, tako se ne more
utemeljiti razredne estetike, umetnosti, arhitekture, ampak samo
razredno kritiko estetike, umetnosti, arhitekture, mesta.
```
## Seznami
Za neoštevilčen seznam postavko začnite s pomišljajem.
- hruške
- jabolka
- slive
```
Za neoštevilčen seznam postavko začnite s pomišljajem.
- hruške
- jabolka
- slive
```
Seznam lahko poljubno "gnezdite" z dvema presledkoma.
- hruške
- viljamovka
- rdeča viljamovka
- krasanka
- jabolka
- slive
```
- hruške
- viljamovka
- rdeča viljamovka
- krasanka
- jabolka
- slive
```
Za oštevilčen seznam postavko začnite s številko in piko.
1. ena
2. dva
3. tri
```
Za oštevilčen seznam postavko začnite s številko in piko.
1. ena
2. dva
3. tri
```
## Zunanje povezave
Povezave do *zunanjih* spletnih strani so sestavljene iz dveh delov. Iz
prikaznega naslova, postavljenega med oglate oklepaje, in urlja,
postavljenega med navadne oklepaje. Če pogledamo primer iz uvoda:
> Za celotna navodila se posvetujte z [Markdown:
Syntax](https://daringfireball.net/projects/markdown/) ali [Formatting
wiki pages](https://ikiwiki.info/ikiwiki/formatting/).
```
Če pogledamo primer iz uvoda:
> Za celotna navodila se posvetujte z
[Markdown: Syntax](https://daringfireball.net/projects/markdown/) ali
[Formatting wiki pages](https://ikiwiki.info/ikiwiki/formatting/).
```
## Slike
![Alt text](https://upload.wikimedia.org/wikipedia/commons/thumb/d/da/Adolf_Loos%2C_1910%2C_A1130_Wien%2C_St._Veit-Gasse_10%2C_Haus_Steiner.jpg/640px-Adolf_Loos%2C_1910%2C_A1130_Wien%2C_St._Veit-Gasse_10%2C_Haus_Steiner.jpg "Optional title")
[[!img link="https://upload.wikimedia.org/wikipedia/commons/thumb/d/da/Adolf_Loos%2C_1910%2C_A1130_Wien%2C_St._Veit-Gasse_10%2C_Haus_Steiner.jpg/640px-Adolf_Loos%2C_1910%2C_A1130_Wien%2C_St._Veit-Gasse_10%2C_Haus_Steiner.jpg"]]
## Direktive (tako imenovane)
# Ikiwiki osnove
Poleg standardnega *markdown* formatiranja, *ikiwiki* omogoča uporabo
dodatnih funkcij.
Za povezave do *notranjih* strani, to je do strani tega wikija, ime
strani natipkajte znotraj dvojnih oglatih oklepajev: [[kazalo]]. Pri
povezovanju z wiki stranmi je mogoče uporabiti tudi drugačen prikazen
naslov. Povezava do strani "kazalo" bi lahko izgledala [[tako|kazalo]].
```
Za povezave do *notranjih* strani ime strani natipkajte znotraj dvojnih
oglatih oklepajev: \[[kazalo]]. [...] Povezava do strani "kazalo" bi
lahko izgledala \[[tako|kazalo]].
```
Več o uporabi tako imenovanih "wikilinks" si lahko preberete na
[povezavi](https://ikiwiki.info/ikiwiki/wikilink/).
V primeru, da stran še ne obstaja, bo prikazana povezava za
ustvarjanje nove strani.
Sledi povezava do [[neobstojece_strani]].
```
Sledi povezava do \[[neobstojece_strani]].
```
Strani wikija so organizirane kot datoteke v direktorijih. Sledi
povezava do [[podstrani neobstoječe strani|neobstojeca_stran/podstran]].
Sledi povezava do [[podstrani neobstoječe
strani|neobstojeca_stran/podstran]].