Učebnice PHP: Redakční systém

Toto vlákno slouží k debatě o redakčním systému, na kterém poběží připravovaná učebnice PHP.

Shrnutí poznatků z předchozí diskuse:

Padl návrh využít diskusi (djpw), přičemž bychom asi museli oželet některé funkce, nebo si udělat vlastní.
Yuhů nabídl zkusit vyjednat použití dokumentačního systému nette.org
Padl také návrh místo redakčního systému texty ukládat do nějakého systému pro správu verzí. Můj provizorní systém pro texty které mám rozpracované, mít je jako .txt soubory na Dropboxu, je svým způsobem primitivní varianta tohoto.

Systém by měl umět:
- Uživatele s oprávněními
- Články s verzováním (ukládáním jednotlivých revizí textu)
- Článek, nebo možná dokonce konkrétní revizi textu(?) by bylo možné mít v rozpracovaném stavu, který nebude zveřejněný
- Zadávání příspěvku asi podobně jako tady na diskusi, ideálně aby to umělo i vychytávky co umí diskuse.
- U většiny článků asi budou odkazy na další materiály, které by možná bylo šikovné držet zvlášť (případně by možná byly zajímavé i informace jak jsou články provázané, odkud se na daný článek odkazuje apod.)

Jan Tvrdík:
Asi bych dal ještě autora celé stránky (i když možná ne, to bude vlastně autor první revize) a popis k URL.
Jak se budou řešit práva uživatelů?

Jan Tvrdík:
„Má k tomu někdo něco?“
Už mě napadla jen taková drobnost, že by možná bylo užitečné BB značky rozšířit ještě o styl pro „klávesu“.
Mám na mysli když se v textu bude popisovat třeba klávesová zkratka.

„Mám začít ten redakční systém programovat nebo jak to uděláme?“
Zadání je dostačující?
Si nejsem úplně jistý, kdo by o tom vlastně měl rozhodnout :-)

Alphard:
„Takže preferujeme BB značky? Kvůli využití místního javascriptu? Podobně jako Majkl jsem předpokládal spíše využití Texy!.“
Předpokládal jsem, že prostředí bude podobné jako na diskusi.
Zas nevím, jestli zavádět další nezávislou syntaxi.

„Týden se nikdo nevyjádřil, můj návrh nezavrhovat dokumentační systém Nette nyní moc nadějně nevypadá“
Zkusím u Yuhůa zjistit, jaký je stav.

Další námět na užitečnou funkci odsud:
V CMS by mohl být seznam termínů a nějaká značka pro termín (která by udělala cursor:help, čárkované podtržení a nastavila title)

Něco na způsob: „V [termin="IDE"]IDE[/termin] byste měli nastavit…“
a výsledek by byl asi takový:

Petr ZZZ:
Toho jsem se přesně bál, že se někdo začne pitvat v textaci té vysvětlivky. Napsal bych tam „Lorem ipsum dolor sit amet“, ale to by zas nemuselo být všem zřejmé o co jde.

Prosím všechny zdejší korektory, aby posílali připomínky jen k reálným textům v učebnici a ne k příspěvkům tady v diskusi, demonstračním textům a podobně.

Takže půjdeme cestou vlastního systému?

Téma nějak usnulo, jak to tedy uděláme?

Jan Tvrdík:
Momentálně je stav takový, že jsem dal dohromady nějaký primitivní systém na zobrazování článků, rozdělování do kategorií a takové věci, na kterém běží php.it-joker.cz.
Uživatelské prostředí neexistuje, články se píší přes textový editor a změny dělají přes phpMyAdmin.

Jestli máš chuť něco naprogramovat, tak klidně, snad jediné co by to mělo zachovat z toho stávajícího je zpracování BB-značek. Můžu dodat zodpovědnou funkci (přičemž to není nic jiného, než upravená funkce na zpracování BB značek z téhle diskuse).

Jan Tvrdík:
„Čeká se na funkci na zpracování BBCode od Jokera“
Posílal jsem ji mailem už dopoledne.

„Je potřeba vyřešit, jak tam zapojit Chamurappiho všeumějící skript (djpw.js)“
Je potřeba? Vzhledem k tomu, že nebude veřejně možné nic editovat ani přidávat nějaké příspěvky?
To jsem upřímně řečeno ještě vůbec neřešil, licenčně ani funkčně.

Jan Tvrdík:
„A jak píšeš ty texty ty?“
V PSPadu většinou, neměl jsem s tím problém.
Můj dojem je spíš opačný, k Texy! bych musel mít nějakou nápovědu na syntaxi, BBCode zvládnu zpaměti.

„A psát články tady na diskusi má ten problém, že BBCode tady není identický s tím, co bude v redakčním systému (zatím se liší trochu, ale časem mohou rozdíly přibývat).“
Já se právě snažil být kompatibilní. Respektive jsou věci, které v RS nebudou z principu (moderátorské poznámky, určení jazyka kódu podle sekce fóra a podobně). Ale jinak by měl příspěvek napsaný tady na diskusi fungovat obdobně. Akorát redakční systém bude mít ještě další značky navíc.