DW-urejevalnik: oblikovanje
Nazaj: urejevalniki in prikaz kode
Kateri gumb v orodni vrstici urejevalnika vstavi kateri znak skladnje – ločeno za strani Markdown in strani DokuWiki, saj vrstici nista isti.
1. Pregled in namen
Stanje: [Live] – dokumentira preslikavo žetonov sintakse
obstoječih orodnih vrstic urejevalnika (EasyMDE za strani Markdown,
jedrna orodna vrstica za strani s sintakso DokuWiki; za preklop glej
editors → preklop).
Referenca za izbor kategorij (ne za ciljno obliko zapisa!): DevExpress-ov
ASPxHtmlEditor
(https://demos.devexpress.com/ASPxHTMLEditorDemos/Default.aspx) –
tam prikazane oznake HTML za to knjižnico ne veljajo.
2. Predpogoji
preklop urejevalnik ↔ označevanje že razumljen.
3. Pojmi
Zakaj ne HTML: urejevalnik ureja izvorno besedilo wiki, ne HTML
– ista ograja kot v osnovah:
označevanje ostane oblika zapisa za shranjevanje, WYSIWYG je le pogled nanj. Ukaz
oblikovanja zato nikoli ne vstavi oznak
<b>/<i>, temveč ustrezen žeton sintakse – DokuWiki-jev
lastni izrisovalnik (oziroma ParsedownRenderer pri wvdsdwmd na
straneh Markdown) nato prevzame ustvarjanje HTML.
4. Prvi koraki
Vsak ukaz zapiše sintakso DokuWiki ali Markdown, odvisno od oblike zapisa, v kateri je urejana stran shranjena (samodejno zaznavanje oznake odloči, katero obliko zapisa ima stran) – ročni korak izbire oblike zapisa ni potreben.
5. Uporaba
Za znakovne oblike (krepko/ležeče/…) odsek 6, za odstavkovne oblike (naslovi/seznami/…) odsek 7.
6. API referenca: znakovne oblike
| Ukaz orodne vrstice | Sintaksa DokuWiki | Markdown |
|---|---|---|
| Krepko | **Besedilo** | **Besedilo** |
| Ležeče | //Besedilo// | _Besedilo_ |
| Podčrtano | __Besedilo__ | brez nativnega ustreznika Markdown – ukaz ostane onemogočen na straneh Markdown (brez rezervnega HTML, glej odsek 3) |
| Prečrtano | <del>Besedilo</del> | ~~Besedilo~~ |
| Monospace (znotraj vrstice) | ''Besedilo'' | `Besedilo` |
| Nadpisano/podpisano | <sup>Besedilo</sup>/<sub>Besedilo</sub> | brez nativnega ustreznika – onemogočeno |
7. Parametri, možnosti in stanja: odstavkovne oblike
| Ukaz orodne vrstice | Sintaksa DokuWiki | Markdown |
|---|---|---|
| Naslov 1–5 | ====== … ====== … == … == (raven = število znakov =') | ''# … … ##### … | |
| Neurejen seznam | * Vnos (dva presledka + zvezdica, ena fizična vrstica na vnos — glej odsek 9) | - Vnos |
| Urejen seznam | - Vnos | 1. Vnos |
| Citat/blockquote | > Besedilo | > Besedilo |
| Blok kode | <code lang>…</code> | ```lang … ``` (fenced code block) |
8. Popolni primeri
Se ne uporablja — čista referenčna tabela žetonov, brez izvedljivega primera.
9. Omejitve in robni primeri
Past: prelom vrstice v seznamu. Urejevalnik WYSIWYG, ki dolg vnos
seznama samodejno vizualno prelomi, pri ponovni serializaciji ne sme
zapisati pravega preloma vrstice v izvorno besedilo DokuWiki — vnos
seznama mora ostati ena sama fizična vrstica izvornega besedila, sicer
pri naslednjem izrisu izpade iz seznama in se prikaže kot surov
<pre> (ista past, ki je bila ročno popravljena na več podstraneh
tega dokumentacijskega kroga – tu zabeležena kot zahteva specifikacije
za prihodnji urejevalnik, ne le kot avtorska napaka).
10. Dostopnost in združljivost
Celoten pregled: Accessibility.
11. Odpravljanje težav
Se ne uporablja.
12. Sorodne teme
- urejevalniki in prikaz kode – osnove in pogodba WYSIWYG
- DW-urejevalnik: tabele in mediji – sintaksa tabel/medijev/povezav
- Markdown (wvdsmd) – tok Markdown, samodejno zaznavanje oznake