Tento návod obsahuje jen základní informace psané na míru pro tým MKP. Podrobnější manuál chystáme.
- šablona github.com/next-book/boilerplate
- seznam knih books-are-next.github.io
Vytvořte si účet ve službě github.com a pošlete své uživatelské jméno Honzovi, přidá vás do organizace books-are-next, kde vznikají konvertované knihy.
Stáhněte si knihu z katalogu MKP ve formátu EPUB, nejlépe nějakou z let 2019 a pozdějších (používají stabilnější definice stylů).
- Ve webovém protředí Github se přepneme do šablony webových knih next-book/boilerplate.
- Vytvořte nový repozitář ze šablony klikem na tlačítko “Use this template” (viz obrázek). Pokud tlačítko nevidíte, nejspíše nejste přihlášeni — přihlaste se ke svému účtu ve službě GitHub.
- Zvolte umístění (organizace books-are-next) a pojmenujte nový repozitář ve formátu jméno-příjmení-autora_název-knihy. Repozitář nastavte jako veřejný (public).
V nově vytvořeném repozitáři nahrajte soubor EPUB (Add file → Upload files) do složky epub (viz Obrázek 2). Potvrďte uložení změn tlačítkem “Commit changes”.
U daného repozitáře zvolíme v horním menu „Settings“ a přesuneme se do položky „Pages“ v podmenu. U položky Source v sekci GitHub Pages a nastavíme „Branch: docs“ a uložíme tlačítkem „Save“ (druhá kolonku ponecháme na hodnotě „/ (root)”).
Po chvíli se zobrazí zelený pruh s informací, že kniha byla publikována.
Odkazy na exportované knihy jsou nejlépe k nalezení v seznamu knih. Knihy se ukládají do počítače, aby je bylo možné číst v offline režimu — proto je pro náhled na aktuální knihu potřeba použít anonymní okno (pokud uděláte knize změny, uvidíte nejspíš starší verzi knihy).
Najdete zde odkazy na
- repo — samotný repozitář s uloženou knihou
- actions — záložka v repozitáři, kde je vidět proces generování knih (zásadní jsou červené puntíky a zelené fajfky, které indikují úspěch konverze)
- book — vygenerovaná kniha
- converter — rozhraní konvertoru pro doplnění detailů knihy
Konvertor se snaží vytáhnout co nejvíce informací ze samotného EPUBu, ale některé informace je možné doplnit: týká se to především struktury obsahu a metadat. K tomu můžete použít rozhraní konvertoru (viz odkaz v předchozí sekci).
Nejdůležitější funkcionalita konvertoru je následující:
- na úvodní straně „Metadata“ můžete editovat… metadata
- na stránce „Structure“ můžete upravit strukturu obsahu, vyznačit titulní a předělové stránky apod.
- na stránce „Export“ pak zkopírujete data, která uložíte do souboru v repozitáři — přímo u textového pole najdete odkaz na příslušný soubor (data se zkopírují do schránky a můžete smazat obsah souboru a vložit do něj obsah schránky, potvrdíte tlačítkem Commit changes)
Podrobný manuál ke všem funkcím tohoto rozhraní ještě ladíme a bude užitečné na něj mrknout, až zvládneme základy. Prozatím je rozpracovaná verze viditelná na google docs.