Tipy a triky pro DokuWiki

https://www.dokuwiki.org/tips

Zde se shromažďují tipy a triky pro používání DokuWiki.

Hustě upravovaný strojový překlad z anglické verze Tips and Tricks for DokuWiki.

Některé tipy jsou zastaralé a nemusí fungovat s nejnovější verzí DokuWiki. Pokud je to možné, opravte je nebo je odstraňte.

Tipy k používání

Odkaz	Stručný popis
TailorWikiRules	Osvědčené postupy po instalaci DokuWiki
Syncing with Unison	Synchronizace dvou wiki nástrojem Unison
Časové pásmo	Nastavení časového pásma serveru
Konfigurace pošty	Jak zprovoznit odesílání e‑mailů
commonlogin	Sdílení autentizačních dat mezi wiki na stejném serveru
Zobrazování prázdných řádků v tabulkách	Zobrazení prázdných řádků v tabulkách
Dobrý styl	Jak mít hezké a použitelné styly v DokuWiki
Accessibility	Tipy k přístupnosti pro editory
upgrading old versions	Jak upgradovat ze starých verzí DokuWiki (2005-*)
ShowMediaFromExternalUpload	Zobrazení souborů nahraných jinak než přes správce médií

Rozšíření syntaxe

Většinu těchto tipů je třeba upravit pro nový devel:Parser a nebudou fungovat okamžitě; mnohé je vhodnější realizovat jako plugin.

Odkaz	Stručný popis
magnet_links	Zobrazovat DC++ magnet odkazy jako externí
Odkazy na příkazy DokuWiki	Vytváření odkazů na „DokuWiki akce“ (?do=) přímo z obsahu wiki (Action Modes / Action Links, obecně URL tagy)
tex_howto	Záplata (pro verzi 2005-05-07), která přidává podporu matematických výrazů AMSLaTeX v DokuWiki

Rozšíření rozvržení a stylů

Část těchto tipů může být lépe realizována přes Šablony; doporučeno podle toho je přepsat.

Odkaz	Stručný popis
Horní lišta (Top Bar)	Přidání horní lišty jako na dokuwiki.org
Vlastní citace	Úprava vzhledu citací
format user	Zobrazení CN z klientského certifikátu místo jména uživatele
Zakázání ikon u odkazů	Vypnutí ikon interwiki a externích odkazů
Popisy v RSS agregátoru	Přidání úvodů článků do výpisu RSS
CSS kód	CSS pro zvýrazňování syntaxe
geshi style builder	Tvorba stylů pro GeSHi
XHTML5	Jak přepnout na XHTML 5
XHTML Strict	Jak přepnout na XHTML 1.0 Strict
Fixní pozice TOC	TOC zůstává fixně při scrollování
Číslované nadpisy	Číslované nadpisy čistě pomocí CSS
Zpět nahoru	Odkaz „zpět nahoru“ před každým nadpisem
Lokální odkazy s ikonami	Lokální odkazy doplněné ikonami
Vlastní SVG ikony	Vytváření vícerezných (multi‑color) SVG ikon pro DokuWiki
obrázek v pravém horním rohu	Nahrazení výchozího loga DokuWiki vpravo nahoře vlastním
code in ordered lists	Vkládání kódu do číslovaných seznamů
tableswithrowspans2	Tabulky s podporou rowspan
Tables with Rowspan	Další způsob, jak zajistit rowspan v tabulkách
rowspansfix	Ještě jeden způsob, jak umožnit rowspan
rowspansfix2	Ještě jeden způsob, jak umožnit rowspan
Přizpůsobení výšky iframe	Doplňkový JavaScript k plugin:iframe pro výšku podle obsahu
Stylování nadpisů pomocí CSS	Obecné rady, příklady a struktura pro úpravu nadpisů
Změny u položek ve „Recent changes“	Zobrazení diffu mezi poslední a aktuální verzí u každé položky přehledu
Náhled tisku	Náhled těla wiki; použití pro tisk nebo fullscreen mód
Dvojitým kliknutím otevřít úpravy	Otevření sekční editace na dvojklik (vylepšené)
Jednoduché sloupce	Implementace sloupců bez pluginů
Zarovnání tlačítka	Jak zarovnat element <button>
Dodatečné InterWiki zkratky	Sdílení vlastních InterWiki zkratek
Dělení slov v nadpisech a odkazech (německy)	Dělení slov v nadpisech a link textech (German: Worttrennungen …)

Přidávání funkcionality

Odkaz	Stručný popis
Auto‑odběr mailing listu	Automaticky přihlásí uživatele k mailing listu po registraci
Lepší e‑mailová oznámení	HTML notifikace o změnách stránek
Čisté schéma notifikací	Vyjasnění: subscr. jmenného prostoru při nové stránce, subscr. stránky při aktualizaci
ACL podle IP	Přidělení práv podle IP nebo sítě klienta
Detekce jazyka prohlížeče	Automatická detekce jazykového rozhraní
transliteration	Transliterate cyrilice do latinky
Export do PDF	Export přes html2ps a pstopdf
Tlačítko Print View (vyžaduje login)	Využívá ?do=export_html
tpl_button pro tisk	Přidá tpl_button pro tiskový náhled
User Link (vyžaduje login)	Využije zvláštní wiki stránku pro uživatele
StickyExportHtml	„Přilepí“ do=export_html pro prohlížení jen jako HTML
Pouze HTML zobrazení	Podobné jako výše, přes .htaccess rewrite
Diskuze	Tlačítko/odkaz v šabloně na separátní diskusní stránku (jako na Wikipedii)
Bezpečné zahrnutí PHP kódu	Povolit vkládání PHP kódu jen na stránkách superusera
Statistiky stránek	Logování přístupů ke stránkám a médiím
Jednoduché logování	Jednoduchý logging DokuWiki
NLS	Neoficiální podpora národních jazyků
Vynucení shrnutí	Vyžadovat vyplnění shrnutí (nebo „Minor edit“)
Tlačítko na panelu nástrojů	Přidání vlastního tlačítka do toolbaru
Domovské stránky	Automatická tvorba uživatelských stránek při přidání/změně účtů
Počítadlo slov	Počítadlo slov/znaků ve formuláři editace
Mediamanager a velikost souboru	Přidá velikost vybraného souboru do wikilinku
media attached	Nahraná média se „připojují“ ke stránkám
template chooser	Rozbalovací seznam v režimu editace pro vložení obsahu ze šablony
login instead of forbidden	Ukázat login formulář při přístupu na zakázanou stránku
display acls	Zobrazit ACL v patičce stránky
action menu	Akční menu po vzoru MoinMoin Wiki
export html	Export více stránek do HTML
newssystem	Systém novinek; existuje i plugin a NEWS System
subscription	Nezasílat e‑maily o změnách jejich autorům‑odběratelům
phashLogin	Přihlášení pomocí GET a phash (užitečné např. pro RSS čtečky)
Integrace TinyURL	Automaticky vytvářet krátké URL pro každou stránku
Filtr Recent Changes	Filtrovat přehled „Recent Changes“ podle uživatele (verze 2009‑02‑14)
Separate Admin Login	Speciální admin login bez práv číst/upravovat obsah
User Pages	Každému dát AUTH_EDIT na stránce v určeném prostoru, jejíž název je jeho jméno
ClickNShow	Skrývání/zobrazování sekcí klikem na nadpis
Drobná změna ve výchozím stavu	Automaticky zaškrtne „Drobná změna“
Čítač zobrazení	Jednoduché počítadlo zobrazení stránky
Vytvořit knihu	Jak vytvořit knihu v DokuWiki
Namespace Clouds	Patch „Namespace Discrimination“ pro Cloud plugin
Copy Section Link	Jednoduché kopírování odkazů na sekce (JavaScript)
pageaccueil	Úvodní stránka se seznamem kategorií a tvorbou nové stránky/kategorie

Integrace s dalšími systémy

Auth pluginy umožňují přihlášení v DokuWiki pomocí účtů z jiných platforem. Viz Auth Plugins v repozitáři.

Ostatní

Odkaz	Stručný popis
Synchronise with Tomboy	Jak synchronizovat Tomboy s DokuWiki
Integrace DokuWiki do webu	Jako stránky jen pro čtení
Edit DokuWiki with text editors using FUSE and Python	Netestováno, může být nestabilní
Researchr (nefunkční)	Rámec pro integraci DokuWiki s BibDesk a Skim pro akademické poznámky a citace

Skripty a nástroje

Odkaz	Stručný popis
DokuWiki Setup	Snadná/automatická instalace/upgrade, řeší i safe‑mode
Údržba	Cron úlohy pro udržování wiki
Backup Script	Malý shell skript pro zálohy dat a médií s rotací
BackupToS3	Malý Ruby skript pro zálohy na Amazon S3
UpgradeScript	Skript pro zjednodušení aktualizací DokuWiki
Weblog bookmarklet	JavaScript/PHP kombinace pro publikování do DokuWiki jako do blogu
imap2wiki	Malý PHP skript umožňující publikovat e‑mailem
DokuVimKi	VIM plugin pro editaci stránek přes XML‑RPC + zvýraznění syntaxe DokuWiki
vimkeys	Klávesové zkratky pro [G]Vim
fixperms.php	Učinit soubory vytvořené webserverem zapisovatelnými pro všechny
mail2page	Tvorba stránek a nahrávání médií e‑mailem
romanize	Romanizace názvů souborů v datadir
DokuWiki2HtmlHelp	Konverze DokuWiki webu do CHM (Compiled HTML Help) včetně obsahu a rejstříku
jEdit	Mód pro jEdit se zvýrazněním nadpisů, formátů, seznamů a odkazů
CLI	Příkazové nástroje DokuWiki
recreate wiki change log	Obnovení globálního changelogu ze změnových logů jednotlivých stránek
readINIfile	Jak řešit vypnuté parse_ini_file
fixmtime	Oprava časů úprav podle timestampů (vyhne se „external edit“ syndromu)
clean acl	Úklid neexistujících uživatelů a stránek v ACL
Čištění adresáře médií	Malý Perl skript pro úklid osiřelých souborů v médiích
Přihlášení a stažení stránek přes cURL	Rychlý návod na stahování stránek vyžadujících přihlášení pomocí curl
Extrahovat externí odkazy	Malý PHP skript pro extrakci všech externích odkazů (s kontextem)
Autolink	Malý Perl skript pro (re)build odkazů na zvolená slova každou noc
Automatizované build reporty	Bash skript, který sestaví projekt a pošle výsledek do wiki
GourceDoku	Vizualizace historie úprav wiki pomocí Gource
Nejlepší přispěvatelé	Shell snippet pro seznam „top“ přispěvatelů wiki
locateorphanmedia	Jak vypsat všechna osiřelá média (soubory bez odkazů ve wiki)
Anotace stránky	Skript ukazující, kdo upravil který řádek; používá git
MySQL pro všechny	Mimo‑wiki web skript, který uživatelům umožní generovat SQL dotazy pro použití v pluginech wiki, bez znalosti DB struktury a syntaxe
Dokuwiki orphans (nefunkční)	Pomůže najít stránky bez příchozích odkazů a odkazy na neexistující stránky

Import z externích zdrojů

Wiki

Zdrojová wiki	Popis
ChuWiki	Python skript pro převod z ChuWiki
ErfurtWiki	PHP skript pro převod z ewiki (ErfurtWiki)
JSPWiki	Plugin pro import stránek z JSPWiki
JSPWiki (znovu)	Dvojice skriptů pro převod adresáře stránek z JSPWiki
MediaWiki	Konvertor MediaWiki → DokuWiki
MoinMoin	Python a PHP skripty pro převod z MoinMoin
Perspective	Python skript, spouští se z Windows
TikiWiki	PHP skript pro převod z TikiWiki
trac	PHP skript pro převod wiki z Tracu
TWiki	Skript pro převod z TWiki
Wakka Wiki	Perl skript pro převod z Wakka Wiki
Zwiki	Perl skript pro převod z Zwiki
docpdf2dokuwiki	Perl skript pro import PDF a DOC
Atlassian Confluence	Perl skript pro převod z Confluence

Ostatní

Odkaz	Popis
uploadcodedir	Nahrávání adresáře se zdrojovými kódy do DokuWiki
table editing	Jak importovat data do tabulek
Wikemail	Skript pro import e‑mailů do DokuWiki
OpenOffice Macro	Převod dokumentu OpenOffice do syntaxe DokuWiki
OpenOffice v2 Macro	Převod dokumentu OpenOffice do syntaxe DokuWiki (upraveno pro OOo v2)
OpenOfficeMacro	Makro převádí také vložené obrázky (což výše uvedená makra neuměla)
Writer2Dokuwiki	Převod dokumentu OpenOffice do syntaxe DokuWiki (neplná podpora seznamů)
Writer2Dokuwiki (IT‑Bayer) (německy)	Převod dokumentu OpenOffice do syntaxe DokuWiki
Calc2Dokuwiki	Export vybraných oblastí buněk z OpenOffice Calc do tabulek formátovaných jako DokuWiki; jako rozšíření (OOo 2.1.x) i makro (OOo 1.x–2.x)
HTMLtoWiki	Jak převést HTML do syntaxe DokuWiki
Excel → DokuWiki konvertor	Makro nástroj s parametry na prvním listu; vložte tabulku na jiný list, označte buňky a spusťte export do DW syntaxe včetně stylů. Informace je i zde v DokuWiki: tips:excel_macro
csv2dwt	Skript, který převádí CSV (Comma Separated Values) do tabulkového formátu DokuWiki (DWT).
csv2dokuwiki	Převádí CSV vstup (tabulátorově oddělený) do tabulkové syntaxe DokuWiki (v Javě).
xls2wiki	Skript, který převádí zkopírovaná data z XLS do tabulkového formátu DokuWiki (DWT) a naopak.
doc to wiki syntax	Konverze složek se soubory MS Word (DOC) do syntaxe DokuWiki.
Word → DokuWiki konvertor	Ke stažení je zde aktuální verze tohoto dokumentu obsahující makro pro export do DW syntaxe. Některé informace jsou přímo v DokuWiki na tips:word_makro. Starší verze od Tanii Hew ⇒ Word to DokuWiki Converter vylepšuje obě výše uvedená makra, protože jde o šablonu Wordu, která umožní jedním tlačítkem převést dokument Wordu včetně obrázků do formátu DokuWiki (viz Portfolio na webu).
Úprava Word makra	Převádí dokument MS Word do formátu DokuWiki – vylepšená konverze (pro anglický Word) plus úprava pro německý Word.
word2wiki	Převod obsahu dokumentu Microsoft Word do wiki značek.
google sheets macro	Google Apps Script pro export vybraného rozsahu buněk do DokuWiki.
wordpress user export	Jak spustit dotaz pro export uživatelů z WordPressu tak, aby je bylo možné importovat do DokuWiki.

Různé

Odkaz	Popis
blacklist test	Malý skript, který pomáhá otestovat text vůči blacklist
blogování	Stránka popisuje kroky potřebné k rozběhnutí blogování v DokuWiki
bookmarklets	Pomocníci pro editaci wiki stránek založení na JavaScriptu
výchozí text pro vyhledávání	Přidání výchozího textu do vyhledávacího pole
disabled functions	Záplata pro případ, že hosting nepodporuje glob nebo readfile
DwExport	Export DokuWiki do statických HTML stránek včetně obrázků a CSS formátování. ⇒ http://sourceforge.net/projects/dwexport/ Pouze v0.2
farm	Jak udělat z DokuWiki wiki farmu
jednoduché Google vyhledávání	Nahrazení interního vyhledávání DokuWiki vyhledáváním Google
spell checker 713	Aspell osobní slovníky a vydání 2005‑07‑13 (zřejmě zastaralé)
svg.php	Plugin pro DokuWiki umožňující kolaborativní tvorbu SVG obrázků. (Pokud je to možné/užitečné, udělat z toho plugin)
utf8update	Konverze na UTF‑8 v DokuWiki
export2twiki	Převod syntaxe DokuWiki do formátu twiki pro export
phpwithgd	Jak řešit problémy způsobené chybějící podporou gdlib v PHP

Jak na to

Není potřeba žádný plugin ani úpravy.

Odkaz	Popis
Počasí	Zobrazení počasí z https://wttr.in/