Opublikuj artykuły w GitHub

Połącz GitHub raz, a będziesz mógł publikować dowolny artykuł Clevera w repozytorium jako plik Markdown, gotowy do użycia na stronie dokumentacji, w folderze w stylu wiki docs/ lub w kolekcji README. Ten artykuł omawia łączenie, wybieranie repozytorium i folderu, wygląd pliku oraz sposób działania aktualizacji.

Zanim zaczniesz#

• Plan: publikowanie w GitHub jest częścią planów Pro i Custom. W planach Free i Starter karta Opublikuj wyświetla komunikat "Publikowanie w Twoich narzędziach jest zawarte w planie Pro". Zobacz Wybierz plan.
• Rola w Clevera: tylko właściciel obszaru roboczego lub Administrator może połączyć lub odłączyć GitHub. Po połączeniu każdy, kto może edytować artykuł, może go opublikować.
• Dostęp w GitHub: osoba, która dokonuje połączenia, musi mieć dostęp do zapisu w repozytoriach, w których chcesz publikować, oraz prawo do zainstalowania aplikacji GitHub na tym koncie osobistym lub organizacji (lub właściciel organizacji musi ją zatwierdzić).
• Artykuł: publikujesz artykuł, który należy do wideo lub nagrania. Wygeneruj go najpierw; zobacz Zamień nagranie w artykuł.

Publikowanie nie zużywa kredytów.

Połącz GitHub#

1. Otwórz Integracje#

   Na pasku bocznym otwórz menu obszaru roboczego i wybierz Integracje. Znajdź GitHub w sekcji Dostępne integracje (lub na karcie Programowanie) i kliknij Połącz. Przycisk pojawi się, gdy najedziesz kursorem na kartę.

   

2. Autoryzuj Clevera w GitHub#

   GitHub poprosi Cię o autoryzację aplikacji Clevera AI. Wymaga ona dostępu do odczytu członkostwa w Twojej organizacji, aby Clevera mogła wyświetlić konta, do których należysz. Kliknij Autoryzuj.

3. Zainstaluj aplikację w swoich repozytoriach#

   Następnie GitHub otworzy stronę instalacji aplikacji Clevera AI. Wybierz swoje konto osobiste lub organizację, a następnie wybierz Wszystkie repozytoria lub Tylko wybrane repozytoria. Aplikacja prosi o:

   Uprawnienie GitHub	Dlaczego
   Zawartość: odczyt i zapis	Aby tworzyć i aktualizować plik Markdown oraz jego obrazy
   Metadane: tylko do odczytu	Wymagane przez GitHub dla każdej aplikacji; pozwala Clevera wyświetlić listę repozytoriów

   Kliknij Zainstaluj. Powtórz dla każdej organizacji, w której chcesz publikować.

4. Sprawdź połączenie#

   Po powrocie do Integracji, GitHub przeniesie się na listę Połączono z nazwą Twojego konta GitHub lub organizacji oraz plakietką Połączono. Zanim cokolwiek opublikujesz, będzie tam widniał napis "Nic jeszcze nie opublikowano".

   

Dodaj lub usuń repozytoria później#

Clevera widzi tylko repozytoria, w których zainstalowano aplikację. Aby to zmienić, otwórz Integracje, kliknij GitHub, a w sekcji Dostęp kliknij Dostęp do repozytorium. W GitHub otwórz konto, kliknij Skonfiguruj i zmień listę repozytoriów. Nowe repozytoria pojawią się przy następnym otwarciu karty Opublikuj.

Opublikuj artykuł#

1. Otwórz kartę Opublikuj#

   W edytorze kliknij Udostępnij i otwórz kartę Opublikuj. W sekcji Opublikuj artykuł kliknij kafelek GitHub w sekcji Gotowe do publikacji.

   Artykuł jest publikowany w języku, który masz otwarty w edytorze. Najpierw przełącz język na górnym pasku, aby opublikować tłumaczenie.

2. Wybierz konto, repozytorium i folder#

   W sekcji Gdzie trafi wybierz:

   Pole	Co wybrać	Uwagi
   Konto	Twoje konto osobiste lub organizacja	Wyświetlane tylko wtedy, gdy Twoje repozytoria należą do więcej niż jednego konta
   Repozytorium	Repozytorium dla pliku	Ostatnio aktualizowane jako pierwsze. Pierwsze jest wybrane automatycznie
   Folder	Ścieżka taka jak docs lub articles/guides	"Plik Markdown zostanie utworzony tutaj. Pozostaw puste dla katalogu głównego repozytorium." Zaczyna się od docs. Foldery, które jeszcze nie istnieją, zostaną utworzone

   Clevera zapamiętuje Twój wybór na przyszłość.

   

3. Opublikuj#

   Kliknij Opublikuj w GitHub. Zobaczysz "Szukanie istniejącej kopii w GitHub", a następnie Zapisywanie strony. Po zakończeniu zobaczysz "Opublikowano w GitHub". Kliknij Otwórz w GitHub, aby zobaczyć plik.

   Możesz zamknąć okno Udostępniania podczas procesu; powiadomienie poinformuje Cię, gdy będzie gotowe.

Gdzie trafia plik#

• Gałąź: domyślna gałąź repozytorium (zazwyczaj main). Clevera commituje bezpośrednio do niej; nie otwiera pull requesta i nie możesz wybrać innej gałęzi.
• Nazwa pliku: tytuł małymi literami, ze spacjami zamienionymi na myślniki, kończący się na .md. "Create your first invoice" staje się create-your-first-invoice.md. Tytuły w innych alfabetach lub z akcentami są najpierw zapisywane literami łacińskimi ("Créer une facture" staje się creer-une-facture.md). Tytuł, z którego nic nie zostało do zapisania, np. złożony tylko z emoji, otrzymuje krótki stały kod (article- plus 8 znaków). Nazwy są ucinane po 80 znakach.
• Obrazy: zrzuty ekranu z artykułu trafiają do assets/<file name>/ w tym samym folderze, w tym samym commicie.
• Wiadomość commita: Add article: <title> lub Update article: <title> podczas aktualizacji istniejącego pliku.
• Autor commita: konto GitHub, które połączyło integrację.

Jak wygląda plik#

Clevera zapisuje Markdown w stylu GitHub z krótkim blokiem front matter na górze:

---
title: "Create your first invoice"
created_at: "2026-10-12T09:30:00+00:00"
updated_at: "2026-10-12T10:05:00+00:00"
source: "Clevera"
---

Wideo, z którego pochodzi artykuł, nie jest dodawane do pliku. Wideo Clevera umieszczone wewnątrz artykułu staje się linkiem do jego odtwarzacza, tylko wtedy, gdy link udostępniania tego wideo jest włączony. Zobacz Pokaż wideo w artykule.

Obrazy#

Zrzuty ekranu są commitowane do Twojego repozytorium obok pliku, a Markdown linkuje do nich za pomocą ścieżki względnej (assets/<file name>/…). Działają one bez Clevera, a w prywatnym repozytorium pozostają tak samo prywatne jak reszta zawartości.

Plik wideo przesłany do artykułu nie jest commitowany. Pozostaje linkiem do Clevera, który wygasa po pewnym czasie; opublikuj ponownie, aby go odnowić.

Użyj ze stroną dokumentacji#

Większość generatorów stron statycznych, które budują z repozytorium (takich jak Docusaurus, MkDocs, Jekyll lub Hugo), odczytuje title z front matter i ignoruje pola, których nie zna. Typowa konfiguracja:

1. Skieruj Folder na folder, z którego czyta Twoja strona dokumentacji, na przykład docs lub content/guides.
2. Opublikuj tam każdy artykuł; normalna kompilacja Twojej strony przechwyci nowy commit.
3. Sprawdź, czy Twój generator renderuje alerty GitHub, matematykę i <details>; niektóre pokazują alerty jako zwykłe cytaty.

Zaktualizuj artykuł, który już opublikowałeś#

Publikowanie działa tylko w jedną stronę. Edycje wprowadzone w Clevera pozostają w Clevera, dopóki nie opublikujesz ponownie, a zmiany wprowadzone w pliku w GitHub nigdy nie wracają do Clevera.

Podczas publikowania do tego samego repozytorium i folderu, Clevera znajduje plik o tej samej nazwie i wyświetla "Ten artykuł jest już w GitHub". Kliknij Wyświetl go, aby otworzyć istniejący plik, a następnie wybierz:

Jeśli tytuł zmienił się w Clevera, nazwa pliku również ulega zmianie, więc publikacja tworzy nowy plik obok starego. Usuń lub zmień nazwę starego pliku na GitHub samodzielnie.

Nic w Clevera nie usuwa plików z Twojego repozytorium.

Rozłącz GitHub#

1. Otwórz Integracje, kliknij menu ⋯ w wierszu GitHub i wybierz Rozłącz (lub kliknij GitHub, a następnie Rozłącz).
2. Potwierdź. „Nie możesz już publikować w tym miejscu z poziomu edytora. Treści, które już opublikowałeś, pozostają na GitHub”.

Rozłączenie usuwa token dostępu Clevera. Aby usunąć dostęp Clevera również na GitHub, odinstaluj aplikację Clevera AI (Ustawienia GitHub → Applications → Installed GitHub Apps → Configure → Uninstall) i cofnij autoryzację w sekcji Authorized GitHub Apps.

Rozwiązywanie problemów#

Powiązane#