---
tags: robocze
---

# Instrukcja publikacji treści na stronie

Jeśli kończysz pracę z tekstem i chcesz go opublikować, lub chcesz opublikować zmiany w tekście już znajdującym się na stronie, musisz wysłać je do naszego repozytorium na GitHub. W tym celu, użyj opcji "Versions and GitHub Sync".


W oknie które się pojawi możesz porównać aktualny stan dokumentu z wcześniejszymi wersjami. Jeśli uznasz, że chcesz dokonać aktualizacji na stronie, naciśnij "Push to GitHub". Alternatywnie, możesz też pobrać wersję aktualnie znajdującą się w repozytorium za pomocą przycisku "Pull from GitHub".


Przy pierwszym wysyłaniu tekstu na GH zapyta nas czy przełączyć łamanie linii na zgodne z GH. Potwierdzamy ("Switch now".


W następnym kroku należy wybrać dokąd chcemy wysłać nasz tekst. Jeśli to Twój pierwszy raz z łaczeniem HackMD z GitHubem, dodatkowo będzie trzeba połączyć HackMD z MD oraz autoryzować repozytorium - czyli miejsce gdzie przechowywane są pliki danego projektu.

W polu `Select repo` wybierz repozytorium do którego wysyłasz zmiany, czyli w naszym przypadku Tash-Feneko/tranzycja.pl

Następnie wybierasz gałąź projektu ("branch"), czyli odnogę rozwojową. Gałęzie mogą mieć dowolne nazwy - jeśli nie ma jakiejś na liście, to po prostu ją utwwórz, ale pamiętaj, że tylko pod kilka konkretnych nazw gałęzi mamy skonfigurowane domeny. **Dla ułatwienia pracy zespołowej gorąco zaleca się trzymania następujących wytycznych:**

| Branch | domena | opis |
| -------- | -------- | -------- |
| main | tranzycja.pl | Główna gałąź projektu - wszystko co zostanie z nią scalone automatycznie uruchamia budowanie strony i trafia na naszą główną domenę, czyli jest od razu publikowane. **Na tę gałąź nie da się wysłać zmian bezpośrednio.** |
| dev | dev.tranzycja.pl | Gałąź wyłącznie do aktualizowania kodu strony. Nie wrzucaj tutaj zmian treści z HackMD. Za to możesz na domenie tej gałęzi sprawdzać nowe funkcjonalności zanim trafią na stronę :) |
| test | test.tranzycja.pl | Ta gałęź służy dowolnym testom. Możesz na nią wrzucić cokolwiek tylko chcesz, żeby zobaczyć jak będzie wyglądać po przebudowaniu się. Dla zachowania porządku **zmiany z tej gałęzi nie są scalane z main** - jeśli testujesz tutaj jakąś zmianę a następnie chcesz żeby trafiła na stronę, musisz ją wysłać wtedy również do update. |
| update | update.tranzycja.pl | Tutaj umieszczaj treści które uznasz za gotowe do wrzucenia na stronę. Jeśli umiesz, możesz też od razu na GH zlecić pull request do main - wtedy wysłanie takich zmian na stronę to już tylko moment. |

Po scaleniu do main gałąź rozwojowa zostaje usunięta. Gałęzie których w danym momencie nie ma, nie otwierają się pod przypisanymi im domenami.


## Ścieżka i nazwa pliku

W polu "Select file" musisz wybrać plik w repozytorium do którego wysyłasz zmiany. Może to być już istniejący plik, bądź zupełnie nowy. Treści na stornie trzymamy w następujących lokalizacjach:

| Column 1 | Column 2 |
| -------- | -------- |
| source/_ogolne/ | Elementy stałe strony, takie jak stopka czy treść na stronie głównej. |
| source/_aktualnosci/ | Dział aktualności.
| source/_publikacje/ | Publikacje. |
| source/_krok_po_kroku/ | Materiały z działu Krok po kroku |
source/_strony/ | Dodatkowe podstrony linkowane w różnych miejscach (np. menu), takie jak informacja o licencji projektu, czy też możliwościach wspierania |

Właściwe nazwanie pliku jest bardzo ważne, ponieważ nazwa pliku staje się następnie slugiem artykułu.

:::info
Slug, to ostatnie kilka słów w adresie wskazujących na treść otwieranej strony. Więcej o pisaniu dobrych slugów możesz przeczytać np. [tutaj](https://webwavecms.com/blog/slug).
:::

pamiętaj na końcu dodać .md


## Nazwa i opis smiany do repozytorium


- metadane
- aktualizowanie już istniejącego tekstu