DW-urejevalnik: oblikovanje

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 ciljni format!): 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 format shranjevanja, 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 formata shranjevanja urejane strani (samodejno zaznavanje oznake odloči, kateri format ima stran) — ročni korak izbire formata 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