DW-urejevalnik: tabele in mediji

1. Pregled in namen

Stanje: [Live] — poglablja oblikovanje z ukazi orodne vrstice za tabele in medije. Referenca kategorij: DevExpress-ov ASPxHtmlEditor (https://demos.devexpress.com/ASPxHTMLEditorDemos/Default.aspx) — cilj je, tako kot na strani oblikovanja, vedno sintaksa DokuWiki oziroma Markdown, nikoli HTML.

2. Predpogoji

oblikovanje že razumljeno.

3. Pojmi

Ista ograja kot pri oblikovanju: vsak ukaz orodne vrstice zapiše sintakso DokuWiki oziroma Markdown, nikoli HTML.

4. Prvi koraki

Brez ločenega koraka priprave — tabele iz odseka 6 sledijo istemu vzorcu kot ukazi oblikovanja.

5. Uporaba

Za tabele odsek 6, za medije/povezave odsek 7.

6. API referenca: tabele

Ukaz orodne vrstice	Sintaksa DokuWiki	Markdown
Vstaviti tabelo (n×m)	`^ Glava ^ Glava ^` + vrstice `\| Celica \| Celica \|`	`\| Glava \| Glava \|` + `\|---\|---\|` + `\| Celica \| Celica \|`
Vstaviti stolpec/vrstico	vstavi dodaten stolpec `\|` oziroma vrstico `\|…\|`, vrstica tabele ostane ena fizična vrstica izvornega besedila (ista past kot pri seznamih, glej odsek 9)	analogno
Združiti celice (vodoravno)	prazna celica neposredno pred `\|` brez besedila (DokuWiki jo samodejno združi s prejšnjo celico)	brez nativnega ustreznika — onemogočeno
Preklopiti vrstico glave	`^` namesto `\|` kot ločilo celic prizadete vrstice	prva vrstica + ločilna vrstica `\|---\|` je vedno glava, brez preklapljanja po vrstici

7. Parametri, možnosti in stanja: mediji

Ukaz orodne vrstice	Sintaksa DokuWiki	Markdown
Vstaviti sliko	`{{namespace:datoteka.png?400\|Nadomestno besedilo}}` (širina izbirno prek `?širina`)	`![Nadomestno besedilo](namespace:datoteka.png)` — navedba širine brez nativnega ustreznika, ostane onemogočena
Povezati sliko	`{{namespace:datoteka.png\|Nadomestno besedilo}}` → zunanje povezovanje `[[cilj>...]]` mogoče le z dodatno, ročno sintakso (brez neposrednega ukaza orodne vrstice, meja jedra DokuWiki)	kot pri DokuWiki: brez neposrednega ukaza
Povezava (Link)	`[[namespace:stran\|Besedilo povezave]]` notranje, `[[https://…\|Besedilo povezave]]` zunanje	`[Besedilo povezave](namespace:stran)` oziroma `[Besedilo povezave](https://…)`
Vdelati video/avdio	`{{namespace:datoteka.mp4}}` (DokuWiki prepozna vrsto medija po priponi datoteke, ločen ukaz ni potreben)	`![Alt](namespace:datoteka.mp4)` — enako prepoznavanje pripone datoteke prek `wvdsdwmd`

Varnost: WYSIWYG medijsko pogovorno okno, ki omogoča prosto vnašanje poti imenskega prostora vstavljene datoteke, jo mora pred vstavitvijo preveriti prek cleanID() (CWE-22, prehajanje poti) — ista meja, ki velja za vsak notranje ustvarjen URL v vtičnikih DokuWiki (cleanID() proti prehajanju poti, wl() proti odprti preusmeritvi, hsc() proti XSS). Medijsko pogovorno okno ni poseben primer le zato, ker deluje vizualno.

8. Popolni primeri

Se ne uporablja — čista referenčna tabela žetonov, brez izvedljivega primera.

9. Omejitve in robni primeri

Past: prelom vrstice pri vrsticah tabele. Tako kot pri seznamih (glej oblikovanje → omejitve) mora vrstica tabele ostati ena sama fizična vrstica izvornega besedila — urejevalnik WYSIWYG pri ponovni serializaciji ne sme zapisati pravega preloma vrstice v vrstico tabele.

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: oblikovanje — znakovne/odstavkovne oblike