Etnetera IT Knihovna

Čeština

English

Čeština

English

Appearance

Jak přispívat do portálu ​

Tento portál udržujeme společně — každý člen IT týmu může přidat nový návod, opravit chybu nebo aktualizovat existující obsah. K přispívání stačí terminál, Node.js a Claude Code. Žádné webové rozhraní, žádný CMS.

Portál je dostupný na

https://hub-library-project.pages.dev

1. Jednorázová instalace ​

Tyto kroky provedeš pouze jednou na novém počítači.

Terminal ​

Otevři Terminal (macOS: Cmd + Space → napsat „Terminal" → Enter).

Node.js ​

Pokud Node.js ještě nemáš, nainstaluj ho přes Homebrew:

bash
brew install node

Ověření:

bash
node --version   # mělo by vypsat např. v22.x.x

Claude Code ​

bash
npm install -g @anthropic-ai/claude-code

Naklonování repozitáře ​

bash
git clone https://gitlab.com/hub-group1744624/hub-library-project.git
cd hub-library-project

Git konfigurace (pokud ještě není nastavena) ​

bash
git config --global user.name "Jméno Příjmení"
git config --global user.email "jmeno.prijmeni@etnetera.cz"

První spuštění Claude ​

bash
cd ~/hub-library-project
claude

Claude Code se poprvé zeptá na přihlášení nebo API klíč. Postupuj podle pokynů na obrazovce. Po přihlášení jsi připraven/a přispívat.

Potřebuješ pomoc s instalací?

Napiš na it@etnetera.cz a IT tým ti pomůže projít instalaci.

2. Každodenní práce ​

Pokaždé, když chceš přidat nebo upravit obsah, postupuj takto:

Krok 1 — Otevři projekt v Claudovi ​

bash
cd ~/hub-library-project && claude

Krok 2 — Stáhni nejnovější změny ​

V Claudu (nebo v jiném okně terminálu) spusť:

bash
git pull

Vždy začínej s git pull

Jinak riskuješ konflikt, pokud někdo jiný mezitím portál upravil.

Krok 3 — Popiš Claudovi, co chceš ​

Napiš svůj požadavek přímo do Claude Code v přirozeném jazyce (viz příklady níže). Claude upraví nebo vytvoří soubory za tebe.

Krok 4 — Zkontroluj výsledek ​

Claude obvykle ukáže, co změnil. Můžeš si stránku prohlédnout lokálně:

bash
npm run docs:dev

Otevři http://localhost:5173 v prohlížeči.

Krok 5 — Potvrd a publikuj ​

Řekni Claudovi:

„Commitni změny a pushni na main."

Claude provede git add, git commit a git push. Po pushnutí se portál automaticky nasadí — změna se objeví na webu za 1–2 minuty.

3. Příklady pokynů pro Claude ​

Piš v češtině, přirozeným jazykem. Nemusíš znát příkazy ani syntaxi markdownu.

Nový návod ​

Vytvoř nový návod na nastavení dvoufaktorového ověření (2FA) v Google Workspace.
Přidej ho do sekce Návody a doplň ho do sidebaru.

Úprava existujícího textu ​

V návodu na VPN připojení změň odkaz na Tunnelblick na aktuální verzi 4.0.
V návodu na Git workflow přidej sekci o squash merge.

Přidání obrázku nebo screenshotu ​

Přidej screenshot přihlašovací obrazovky Hexnode do návodu macOS MDM Enrollment,
hned za nadpis "Přihlášení do Hexnode konzole". Obrázek najdeš v ~/Downloads/hexnode-login.png.

Nová sekce nebo kategorie ​

Vytvoř novou sekci "Bezpečnost" s úvodní stránkou a přidej ji do navigace.
Do návodu na SSH klíče přidej novou sekci o rotaci klíčů.

Oprava nebo aktualizace ​

V návodu na vývojové prostředí aktualizuj verzi nvm na v0.40.0.
Oprav překlep ve druhém odstavci návodu na Confluence.

Čím konkrétnější, tím lepší

Místo „uprav návod na VPN" napiš „v návodu na VPN přidej na konec sekci o řešení problémů na Windows 11". Claude porozumí oběma verzím, ale konkrétní pokyn dá přesnější výsledek.

4. Přidání screenshotu nebo obrázku ​

  1. Přesuň soubor do složky docs/public/images/:

    bash
    mv ~/Downloads/muj-screenshot.png ~/hub-library-project/docs/public/images/

    Pokud složka images/ neexistuje, vytvoří ji Claude automaticky na požádání.

  2. Řekni Claudovi, kde má obrázek použít:

    Přidej obrázek images/muj-screenshot.png do návodu na X, hned po nadpisu "Y".

Claude vloží správnou markdown syntaxi a relativní cestu za tebe.

Podporované formáty

PNG, JPG, SVG, GIF, WebP. Doporučujeme PNG pro screenshoty a SVG pro diagramy. Název souboru piš malými písmeny bez mezer: hexnode-login.png, ne Hexnode Login.png.

5. Časté dotazy ​

Zobrazuje se chyba při git push ​

Nejpravděpodobnější příčiny:

Nemáš přístup k repozitáři — napiš na it@etnetera.cz, IT tě přidá.

Zapomněl/a jsi na git pull — spusť git pull --rebase a zkus push znovu.

Konflikt souborů — řekni Claudovi: „Vyřeš konflikt v gitu a pushni změny." Claude konflikty rozřeší za tebe.

Kdy se změna objeví na portálu? ​

Po úspěšném git push se spustí automatický pipeline. Změna je živá za 1–2 minuty. Stav deploye vidíš na GitLab CI/CD.

Co když editujeme portál dva lidé najednou? ​

Nevadí to — Git umí změny sloučit. Jen vždy začínej s git pull, aby sis stáhl/a poslední verzi. Pokud nastane konflikt, Claude ho vyřeší.

Mohu přímo editovat markdown soubory bez Clauda? ​

Ano. Soubory jsou v docs/. Stačí je otevřít v libovolném textovém editoru, uložit a pushovat. Claude není povinný — jen usnadňuje práci lidem, kteří neznají VitePress syntaxi.

Kde najdu zdrojový kód portálu? ​

Na GitLabu: gitlab.com/hub-group1744624/hub-library-project

Kontakt

Máš otázku nebo narazil/a na problém? Napiš nám na it@etnetera.cz.

Etnetera a.s. — IT tým