---
# System prepended metadata

title: Instrukcja publikacji treści na stronie
tags: [robocze]

---

---
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".

![](https://i.imgur.com/lrjzYlJ.png)

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".

![](https://i.imgur.com/U3HVR0V.png)

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

![](https://i.imgur.com/hsuo5mr.png)

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.


![](https://i.imgur.com/A9YqKcv.png)

## Ś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

![](https://i.imgur.com/Bw85V7m.png)



## Nazwa i opis smiany do repozytorium

![](https://i.imgur.com/WGWeZuj.png)


- metadane
- aktualizowanie już istniejącego tekstu