Vítejte na SRD Kostky!

Editace SRD

Zdrojové texty (obsah) SRD je uložený na Google Drive v příslušných složkách:

Nově je přístup do složek se zdroji pro SRD pouze pro čtení kdo bude potřebovat editovat tak mi napište skrze PM/IM na d20.czopen in new window váš email na google účtu a přidám vám práva. Nebo požádejte přes google drive o přístup editora do jednotlivých složek.

Je to z důvodu že někdo tam dělal destruktivní změny a nehlásil se k tomu, a vzhledem k nastavení google nemám jak daného člověka zablokovat nebo kontaktovat. Vidím jenom jméno a fotku, ale už ne e-mail ani možnost napsat danému člověku zprávu.

Umístění obsahu

"Statické" texty (tzn. všechny základní příručky) jsou nasdílené ve svých příslušných podsložkách.

"Dynamické" texty (tzn. virtuální knihy a vše generované ze snippet - viz tvorba virtuálních knihopen in new window) je umístěné ve svých příslušných podsložkách (tj. /snippets a /templates)

v kořenových složkách pro jendotlivé soubory se nachází ještě README.md. Nechte ho být. Vážně.

Formát a editace obsahu

Všechen obsah je v tzv. "markdown" souborech (koncovka ".md"). To jsou v podstatě normální textové (.txt) soubory s jinou koncovkou. Editovat je lze dvěma způsoby:

  • Online přímo v Google Drive
    • Google Drive v základu neumí otevřít .md soubory - poklepejte na soubor a zobrazí se vám jeho náhled. Nahoře je tlačítko "otevřít v programu", klikněte na něj a zvolte "StackEdit"
    • (Pokud nemáte StackEdit "propojený" se svým Google Drive, tak to teď udělejte/potvrďte. Nemusíte se ničeho bát, je to dost bezpečná aplikace)
    • Soubor se vám otevře v novém tabu prohlížeče ve StackEditu - nalevo máte markdown zápis, napravo náhled jak to bude cca vypadat
    • Zeditujte
    • Nahoře nalevo klikněte na "Synchronize now" (tím své změny uložíte do gDrive - pokud na něj nekliknete, tak si StackEdit bude vaše úpravy pamatovat a můžete se k nim později vrátit, ale do samotného souboru na gDrive se nepromítnou)
  • Ve vašem počítači (méně doporučované, ale možné):
    • stáhněte si soubor k sobě na počítač
    • otevřete a zeditujte jej ve svém oblíbeném textovém editoru (ideálně ale asi NotePad nebo PSPad)
    • nahrajte jej zpátky (aniž byste změnili název)

Editace se neprojeví ihned, ale až při další aktualizaci SRD knihoven.

Založení nového souboru

  • Z počítače:
    • Vytvořte ve svém počítači textový soubor (abc.txt) a přejmenujte ho na markdown (abc.md)
    • Nahrajte jej do příslušné složky
  • Z Google Drive:
    • Klikněte na "Nový - Více - StackEdit" (ano, už musíte mít propojený StackEdit se svým Google Drive)
    • Vznikne soubor "Untitled" - v klidu v něm udělejte, co potřebujete (StackEdit po chvíli změní jméno na správné)

Organizace souborů

Ve složce by měly být jen soubory které srd opravdu potřebuje (*.md a obrázky). Nezakládejte si tam dočasné složky a soubory na delší dobu než je nutné.

Každá knížka by měla mít svoji složku a při větším množství podsložku pro obrázky.

Pojmenovávání souborů a složek

  • Názevy složek a souboru bez přípony by měl být tvořen pouze malými písmeny bez diakritiky a čísly místo speciálních znaků a mezer mít - ([a-z0-9-]*.md)
    • 1-kapitola.md
    • uvod.md
    • obrazek-2.jpg
  • Pro lepší organizaci není na škodu pokud to jde číslovat soubory lepe se pak přidávají věci do menu když je jasné pořadí.