Opublikuj artykuły w GitLab

Połącz GitLab raz, a będziesz mógł publikować dowolny artykuł Clevera w projekcie GitLab jako plik Markdown, gotowy do użycia w witrynie dokumentacji, folderze docs/ lub podręczniku projektu. Ten artykuł omawia łączenie, wybieranie projektu i folderu, wygląd pliku oraz sposób działania aktualizacji.

Zanim zaczniesz#

• Plan: publikowanie w GitLab 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 rozłączyć GitLab. Po połączeniu każdy, kto może edytować artykuł, może go opublikować.
• Tylko GitLab.com: Clevera łączy się z GitLab.com. Serwery GitLab zarządzane samodzielnie nie są obsługiwane.
• Rola w GitLab: Clevera wyświetla projekty, w których połączone konto ma rolę Dewelopera lub wyższą. Aby dokonać commita do chronionej gałęzi domyślnej, to konto zazwyczaj musi mieć rolę Maintainer (zobacz Chronione gałęzie).
• 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 GitLab#

1. Otwórz Integracje#

   Na pasku bocznym otwórz menu obszaru roboczego i wybierz Integracje. Znajdź GitLab w sekcji Dostępne integracje (lub na karcie Programowanie) i kliknij Połącz.

2. Zaloguj się do GitLab i autoryzuj#

   Zaloguj się do GitLab.com, jeśli jeszcze tego nie zrobiłeś. GitLab poprosi Cię o autoryzację Clevera z następującymi zakresami:

   Zakres GitLab	Dlaczego
   api	Interfejs API plików GitLab potrzebuje go do tworzenia i aktualizowania plików
   read_user	Aby wyświetlić Twoją nazwę użytkownika GitLab w Clevera
   read_repository	Aby sprawdzić, czy plik już istnieje
   write_repository	Aby zatwierdzić plik Markdown i jego obrazy

   Kliknij Autoryzuj.

3. Sprawdź połączenie#

   Wrócisz do Integracji z komunikatem „GitLab połączono pomyślnie z” oraz Twoją nazwą użytkownika GitLab. GitLab przeniesie się na listę Połączono z odznaką Połączono. Zanim cokolwiek opublikujesz, będzie widniał komunikat „Nic jeszcze nie opublikowano”.

Opublikuj artykuł#

1. Otwórz kartę Opublikuj#

   W edytorze kliknij Udostępnij i otwórz kartę Opublikuj. W sekcji Opublikuj artykuł kliknij kafelek GitLab 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 projekt i folder#

   W sekcji Gdzie trafi wybierz:

   Pole	Co wybrać	Uwagi
   Repozytorium	Projekt GitLab dla pliku	Projekty, w których masz rolę Dewelopera lub wyższą, najpierw wyświetlane są ostatnio aktualizowane. Pierwszy jest wybrany automatycznie
   Folder	Ścieżka taka jak docs lub articles/guides	„Plik Markdown zostanie utworzony tutaj. Pozostaw puste dla katalogu głównego repozytorium.” Zaczyna się jako docs. Foldery, które jeszcze nie istnieją, zostaną utworzone

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

   

3. Opublikuj#

   Kliknij Opublikuj w GitLab. Zobaczysz „Szukanie istniejącej kopii w GitLab”, a następnie Zapisywanie strony. Po zakończeniu zobaczysz „Opublikowano w GitLab”. Kliknij Otwórz w GitLab, 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łąź projektu (zazwyczaj main). Clevera wykonuje commit bezpośrednio do niej; nie otwiera merge 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 nie da się nic zapisać, np. złożony tylko z emoji, otrzymuje krótki stały kod (article- plus 8 znaków). Nazwy są ucinane do 80 znaków.
• Obrazy: zrzuty ekranu 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 GitLab, które połączyło integrację.

Chronione gałęzie#

GitLab domyślnie chroni gałąź główną i zazwyczaj tylko Maintainerzy mogą do niej wypychać zmiany. Jeśli połączone konto jest Deweloperem, commit zostanie odrzucony z komunikatem „GitLab odrzucił commit: potrzebujesz dostępu Dewelopera lub wyższego, a gałąź nie może być chroniona.” Nadaj temu kontu rolę Maintainer lub zezwól Deweloperom na wypychanie zmian w Ustawienia → Repozytorium → Chronione gałęzie w projekcie.

Jak wygląda plik#

Clevera zapisuje Markdown, który GitLab renderuje, 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 gdy link udostępniania tego wideo jest włączony. Zobacz Pokaż wideo w artykule.

Obrazy#

Zrzuty ekranu są zatwierdzane w Twoim projekcie obok pliku, a linki Markdown wskazują na nie za pomocą ścieżki względnej (assets/<file name>/…). Działają one bez Clevera, a w prywatnym projekcie pozostają tak samo prywatne, jak reszta projektu.

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

Użyj z witryną dokumentacji#

Jeśli GitLab Pages lub inny generator stron statycznych (taki jak MkDocs, Docusaurus lub Hugo) buduje Twoją dokumentację z projektu, wskaż Folder na folder, który odczytuje. Każda publikacja to zwykły commit, więc Twój potok (pipeline) działa jak zwykle. Większość generatorów odczytuje title z front matter i ignoruje pola, których nie zna.

Zaktualizuj już opublikowany artykuł#

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 GitLab nigdy nie wracają do Clevera.

Podczas publikowania w tym samym projekcie i folderze, Clevera znajduje plik o tej samej nazwie i wyświetla „Ten artykuł jest już w GitLab”. Kliknij Zobacz go, aby otworzyć istniejący plik, a następnie wybierz:

Jeśli tytuł zmienił się w Clevera, nazwa pliku również się zmienia, więc publikacja tworzy nowy plik obok starego. Usuń lub zmień nazwę starego pliku w GitLab samodzielnie. Nic w Clevera nie usuwa plików z Twojego projektu.

Rozłącz GitLab#

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

Rozłączenie usuwa tokeny Clevera. Aby unieważnić dostęp Clevera również w GitLab, otwórz menu swojego awatara w GitLab → Edytuj profil → Aplikacje, znajdź Clevera w sekcji Autoryzowane aplikacje i kliknij Unieważnij.

Rozwiązywanie problemów#

Powiązane#