{"id":20664674,"url":"https://github.com/cernockyd/nbepub","last_synced_at":"2026-03-19T17:00:55.111Z","repository":{"id":224091214,"uuid":"510664684","full_name":"cernockyd/nbepub","owner":"cernockyd","description":null,"archived":false,"fork":false,"pushed_at":"2022-07-05T09:22:50.000Z","size":1981,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-17T12:45:35.198Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cernockyd.png","metadata":{"files":{"readme":"README.cs.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-07-05T09:13:33.000Z","updated_at":"2023-03-07T05:07:30.000Z","dependencies_parsed_at":"2024-02-23T18:30:21.012Z","dependency_job_id":"79b733be-c099-487f-9753-afdd415c9256","html_url":"https://github.com/cernockyd/nbepub","commit_stats":null,"previous_names":["cernockyd/nbepub"],"tags_count":0,"template":false,"template_full_name":"next-book/boilerplate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cernockyd%2Fnbepub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cernockyd%2Fnbepub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cernockyd%2Fnbepub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cernockyd%2Fnbepub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cernockyd","download_url":"https://codeload.github.com/cernockyd/nbepub/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242829745,"owners_count":20192052,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-16T19:25:42.398Z","updated_at":"2025-12-24T04:35:23.029Z","avatar_url":"https://github.com/cernockyd.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Next-book Boilerplate\n\nJednoduchý nástroj pro publikování webových knih pomocí next-booku. Vyžaduje základní znalosti v oblasti webového vývoje a práce s příkazovou řádkou.\n\nVíme, že jde zatím o docela vysoké nároky — kdybychom vám mohli s čímkoli pomoci, dejte nám vědět pomocí některého z kontaktů na našem webu [next-book.info](https://next-book.info).\n\n## Co je to next-book?\n\nNext-book je způsob, jak publikovat knihy coby webové stránky.\n\nProč? Denně trávíme neskutečné množství času na webu, ale pro čtení knih je zatím poměrně nevhodný. Není snadné udělat si záložku v půlce stránky anebo odkázat na konkrétní odstavec. Není možné dělat snadno anotace anebo si nastavit zobrazení.\n\nNext-book je jeden z nástrojů, které se snaží tyto problémy řešit. Jde o otevřenou platformu (veškeré nástroje jsou dostupné pod svobodnou licencí).\n\nVíce podrobností najdete na webu [next-book.info](https://www.next-book.info), v češtině též na [stránce pro nakladatele](https://www.next-book.info/cs/). Princip mapování knihy, který umožňuje některé pokročilé funkcionality, je předveden na stránce [publisher test](https://next-book.github.io/publisher/).\n\n## Použití\n\nKaždý next-book je webová stránka. Tento nástroj usnadňuje publikování next-booků ze sady podkladů (texty, grafika apod.).\n\nSoftware je použitelný na osobním počítači — knihovny nyní (srpen 2020) podporují GNU Linux a macOS, ale počítáme s úpravou, aby bylo možné používat i klasický Windows počítač bez instalace linuxového subsystému.\n\nMůžete využít i webové služby typu Netlify, která za vás vyřeší instalaci a další požadavky (viz přednastavený konfigurační soubor `netlify.toml`).\n\n## Požadavky\n\nPodle toho, jaký používáte operační systém, můžete mít některé z těchto nástrojů předinstalované.\n\n- git ([instalace](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git))\n- [node.js](https://nodejs.org/en/)\n- [hugo](https://gohugo.io/) ([instalace](https://gohugo.io/getting-started/installing))\n\n## Spuštění generátoru knih\n\n1. Naklonujte tento repozitář — použijte gitový klient jako např. GitKraken anebo spusťte `git clone https://github.com/next-book/boilerplate.git` v příkazové řádce.\n2. Otevřte příkazovou řádku a nalezněte nově vytvořenou složku `boilerplate` (pokud nevíte jak, podívejte se níže do sekce Troubleshooting).\n3. Spusťte `npm install` (tímto se nainstalují potřebné knihovny do vašeho počítače).\n4. Spusťte `npm run build` (tímto se vygeneruje kniha z pokladů).\n\nPokud šlo vše hladce, měli byste ve složce `boilerplate` vidět složku s knihou (`_book`). Tu můžete nahrát na svůj web — to je celé :)\n\n**Tip:** Náhled knihy můžete otevřít spuštěním `npm run server` — tento příkaz vygeneruje knihu a poté spustí lokální server na adrese [http://127.0.0.1:23011/](http://127.0.0.1:23011/), kde ji zpřístupní.\n\nKniha musí být v gitovém repozitáři, aby se správně verzovala, takže pokud jste knihu stáhli namísto klonování, inicializujte repozitář a commitněte aktuální stav složky.\n\n## Jak publikovat knihu?\n\n- Upravte soubory ve složce `content`:\n  - Kapitoly knihy jsou v souborech s koncovkou `.md`.\n  - Metadata o knize jsou v souboru `_book.md`. (Zde je potřebné specifikovat pořadí kapitol v poli `chapters`.)\n  - Titulní strana je v souboru `_index.md`.\n- Struktura knihy je definovaná v HTML souborech ve složce `layouts`. Tento boilerplate používá pro generování HTML kódu nástroj [hugo](https://gohugo.io/).\n- Vizuální styl a skripty můžete upravit v souborech ve složce `assets`. Vizuální styl je možné definovat ve třech módech (světlý, tmavý, sépie) a je nutné dávat pozor, abyste omylem nepředefinovali některou z barev pro všechny módy (a nedošlo tak třeba k zobrazení tmavého textu na tmavém pozadí).\n- Pro úpravy vygenerovaného HTML můžete použít předpřiravený skript `filters.js` — např. pro snadné nalezení a nahrazení určitých prvků.\n\nPro publikování knihy spusťte `npm run build` a nahrajte složku `_book` na jakýkoli hosting.\n\n## Dokumentace\n\nPři běžném užití oceníte především přehled všech CSS proměnných, které se používají pro nastavení vizuálního stylu knihy: ten najdete v souboru [`_defaults.scss` uvnitř knihovny `@next-book/interface`](https://github.com/next-book/interface/blob/main/src/scss/_defaults.scss).\n\nTento boilerplate používá pro generování HTML kódu nástroj [hugo](https://gohugo.io/) — pokud budete chtít upravit nějakou část HTML kódu knihy (ve složce `layouts`), měla by vám stačit znalost tohoto nástroje.\n\nPokud se budete chtít hlouběji ponořit do práce s next-bookem, budete pracovat primárně se dvěma nástroji: `@next-book/publisher` ke generování knihy a `@next-book/interface` pro zobrazení uživatelského rozhraní knihy:\n\n- [Dokumentace `publisher`](https://next-book.github.io/publisher/api/) je užitečná především tehdy, když chcete lépe porozumět nějaké části fungování next-booku nebo při nečekaném chování. Dokumentace je vygenerována ze zdrojového kódu a doplněná komentáři.\n- Knihovna [`interface`](https://github.com/next-book/interface) je psaná v Typescriptu a používá pro práci s rozhraním frameworky React a redux, je tedy čitelná přímo. Všechny komponenty najdete ve složce `src/js/components`.\n\n## Troubleshooting\n\n### Nejsem si jistý\\*á, zda mám naistalovaný git!\n\nSpusťte příkaz `git version` na příkazové řádce. Pokud dojde k chybě, git nejspíš nemáte nainstalovaný nebo se objevil nějaký jiný problém. (Git by měl být nainstalovaný na počítačích s GNU Linux i macOS ve výchozím nastavení. Na Windows použijte výše odkazovaný instalační postup.)\n\n### Když spouštím příkazy na mém počítači se systémem macOS, vyskakuje na mě chyba `invalid active developer path` nebo vyskočí okno s hláškou `Command Line Tools are required`.\n\nNainstalujte Command Line Tools (pokud vyskakuje okno, kde stačí kliknout na tlačítko Agree/Souhlasím), popř. spusťte instalaci pomocí příkazu `xcode-select --install`.\n\n### Nevím, jak se dostanu do správné složky na příkazové řádce.\n\nPoužijte příkaz `cd` (z anglického „change directory“). Napište `cd` a poté zmáčkněte mezeru a napište cestu k dané složce. Vaše aplikace příkazové řádky bude nejspíše nejprve v nějaké výchozí lokaci (např. uživatelská složka na Linuxu a macOS nebo C:/ na Windows), takže je možné, že budete muset tento postup zopakovat, než se do dané složky dostanete (tip: příkazová řádka většinou umožňuje automatické dokončování názvů — stačí tedy napsat prvních pár písmen a zmáčknout klávesu Tab). Na macOS je možné do okna příkazové řádky přetáhnout složku z aplikace Finder a tímto se cesta napíše automaticky.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcernockyd%2Fnbepub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcernockyd%2Fnbepub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcernockyd%2Fnbepub/lists"}