Wikijs » Historie » Revize 21
Revize 20 (Jan Kadlec, 2023-11-23 09:18) → Revize 21/22 (Jan Kadlec, 2023-11-23 09:23)
!{width:20%}https://js.wiki/img/wikijs-full-2021.b840e376.svg!
h1. Wiki.js
"Wiki.js":https://js.wiki je moderní, open source a funkčně bohatá wiki aplikace, která uživatelům umožňuje snadno vytvářet a spravovat dokumentaci, znalostní databáze a wiki. Je navržena tak, aby poskytovala platformu pro spolupráci a uživatelsky přívětivé sdílení informací v rámci týmu nebo komunity.
h2. Hlavní prvky stránky
Každá wiki.js stránka se skládá z jednotlivých prvků.
!{width:30%}https://docs.requarks.io/assets/ui/ui-basics.jpg!
"Zvětšit":https://docs.requarks.io/assets/ui/ui-basics.jpg
* Hlavní navigace
Hlavní navigace slouží k navigaci mezi stránkami. Princip fungování je stejný jako u adresářové struktury. Jsme tedy schopni přidávat skupiny stránek (složky) a jednotlivé stránky (soubory).
!{width:20%}https://students.kiv.zcu.cz:3443/attachments/download/2952/Screenshot%202023-11-23%20at%2009-00-46%20%C3%9Avodn%C3%AD%20str%C3%A1nka.png!
* Tabulka obsahu stránky
Wiki.js automaticky přidává obsah stránky, který se automaticky tvoří podle nadpisů.
!{width:20%}https://students.kiv.zcu.cz:3443/attachments/download/2953/Screenshot%202023-11-23%20at%2009-16-17%20%C3%9Avodn%C3%AD%20str%C3%A1nka.png!
* Komentáře
Mezi další prvky patří zobrazení komentářů. Ty se zobrazují pod textem stránky. Komentáře pak nemusí ale vidět všichni uživatelé, nýbrž např. pouze jen po přihlášení. Zobrazení se nechá nastavit na stránce správa.
!{width:20%}https://students.kiv.zcu.cz:3443/attachments/download/2954/Screenshot%202023-11-23%20at%2009-24-30%20JCI%20Czech%20Republic%20Wiki.png!
* Vyhledávací políčko
Vyhledávací políčko slouží k vyhledávaní stránek podle zadaného dotazu. Relevantnost výsledků se odvíjí od použitého vyhledávacího modulu.
!{width:20%}https://students.kiv.zcu.cz:3443/attachments/download/2956/Screenshot%202023-11-23%20at%2009-41-01%20%C3%9Avodn%C3%AD%20str%C3%A1nka.png!
* Rozcestník administrátorských funkcionalit
!{width:20%}https://students.kiv.zcu.cz:3443/attachments/download/2955/Screenshot%202023-11-23%20at%2009-41-16%20JCI%20Czech%20Republic%20Wiki.png!
h2. Funkcionalita
# *Spolupráce a úpravy v reálném čase (plánováno):*
Wiki.js podporuje spolupráci v reálném čase, což umožňuje, aby na stejném dokumentu pracovalo více členů týmu současně. Tato funkce podporuje kulturu spolupráce, kdy mohou být informace průběžně aktualizovány a vylepšovány odborníky na danou problematiku.
# *Řízení verzí:*
Díky kontrole verzí uchovává Wiki.js podrobnou historii změn provedených v článcích. Tato funkce poskytuje nejen auditní stopu, ale také umožňuje uživatelům v případě potřeby vrátit se k předchozím verzím. Zajišťuje tak přesnost a spolehlivost vaší znalostní báze.
# *Vyhledávání a zjišťování:*
Wiki.js nabízí výkonnou funkci vyhledávání, která uživatelům umožňuje rychle najít potřebné informace. To zahrnuje vyhledávání v obsahu, metadatech, značkách a přílohách, což usnadňuje objevování relevantních znalostí.
# *Podpora více jazyků:*
Wiki.js podporuje více jazyků, což umožňuje organizacím s globálními týmy sdílet znalosti v jejich preferovaném jazyce. Tato inkluzivita zajišťuje, že znalosti jsou přístupné všem členům týmu bez ohledu na jejich umístění.
# *Přizpůsobení:*
Wiki.js umožňuje přizpůsobit platformu tak, aby odpovídala značce vaší organizace. Můžete použít motivy a šablony, abyste zachovali konzistentní vzhled, který bude v souladu s vaší firemní identitou.
# *Správa uživatelů a oprávnění:*
Wiki.js poskytuje robustní správu uživatelů, která umožňuje definovat uživatelské role a oprávnění. Tím je zajištěno, že citlivé informace zůstanou v bezpečí, a zároveň je umožněn správný přístup správným lidem.
# *Vkládání médií:*
Přímo do článků můžete vkládat různé typy obsahu, včetně obrázků, videí a externího obsahu.
# *Integrace s dalšími nástroji:*
Wiki.js podporuje integraci s dalšími nástroji a službami, jako je Git pro správu verzí a jednotné přihlášení (SSO) pro správu uživatelů. To umožňuje bezproblémové začlenění Wiki.js do stávajících pracovních postupů a systémů.
# *API a Webhooks:*
Wiki.js nabízí rozhraní API a webhooks, které umožňují rozšiřování a automatizaci procesů. Wiki.js můžete integrovat s dalšími aplikacemi a pracovními postupy, což z něj činí univerzální platformu pro sdílení znalostí v rámci organizace.
# *Vlastní hosting:*
Jedním z benefitů je i možnost vlastního hostingu. To může být užitečné při splňování regulatorních a "compliance":https://cs.wikipedia.org/wiki/Korpor%C3%A1tn%C3%AD_compliance podmínek.
# *Editace obsahu:*
* *Markdown Editace:*
Wiki.js používá jako primární editační formát Markdown. Tento lehký značkovací jazyk je jednoduchý na naučení a umožňuje přispěvatelům formátovat obsah bez náročného učení. Díky tomu je přístupný širokému spektru uživatelů.
* *Editace v jazyku Wikitext (plánováno):*
Wiki.js bude umožňovat od verze 3.0 editovat soubory ve značkovacím jazyku Wikitext. To přinese uživatelskou zkušenost s wiki podobnou nástrojům jako je MediaWiki nebo Redmine.
h2. Hlavní moduly
Wiki.js nabízí možnost rozšíření funkcionality pomocí přidání modulů. Moduly se dělí do několika kategorií. Ke každé kategorii je uvedeno pár hlavních modulů. Všechny aktuálně podporované moduly jsou v "přehledu":https://js.wiki/modules na oficiální stránce.
* Analytické nástroje
** Google Analytics
** Google Tag Manager
** Microsoft Application Insights
* Autentizace uživatelů
** Auth0
** Github
** Gitlab
** Lokální databáze
** OAuth2
* Databáze
** MariaDB
** MySQL
** PostgreSQL
** SQLite3
** SQL Server
* Editory
** Vizuální editor
** Markdown
** HTML kód
** API rozhraní REST/ GraphQL (připravované)
* Logging (připravované)
* Search Engines
** Elasticsearch
** Algolia
** Databázový u PostgreSQL
* Úložiště
Úložiště slouží pro synchronizaci a zálohování. zálohování
** Dropbox
** AWS S3
** SFTP
h2. Příklad použití v praxi
* Strana zelených
!{width:10%}https://wiki.zeleneforum.cz/logo_zelene.svg!
Příkladem používání v České republice může být Strana zelených. Na jejich "wiki":https://wiki.zeleneforum.cz/, nazývané Zelená wiki, můžeme najít dokumenty a návody ohledně řízení strany. Strana využívá funkcionality wiki.js, která umožňuje různá přístupová práva pro různé stránky. Stránky přístupné pouze příslušníkům strany jsou např. finanční dokumenty, podklady k jednání, kontakty a zápisy. Naopak přístupné pro všechny uživatele jsou stránky na témata jako fundraising, dary a stránka o vstupu člena do strany.
h2. Dokumentace
https://docs.requarks.io/
h2. Zdroje
https://js.wiki/
---
h3. Komentáře
P.Brada 2023
* - příliš stručné textově, použití pro práci s informacemi/znalostmi velmi kusé a ztracené v textu "byznysově užitečných funkcí", kde to čtenář nebude očekávat
* - ilustrační obrázky příliš velké