Infrastruktura::Strona HSŁ::Blog

1. Wejdź na spejsowego githuba: code.hs-ldz.pl
2. Zaloguj się. Jeśli nie masz konta, to załóż i zaloguj się.
3. Jeśli nie masz uprawnień do edycji spejsowego githuba, to poproś o uprawnienia jedną z osób wymienionych na Wiki.
4. Przejdź do repozytorium homepage, do katalogu _posts.
5. Wejdź do któregoś z plików z rozszerzeniem .md, przejdź na zakładkę Code.
6. Skopiuj zawartość do ulubionego edytora kodów źródłowych, w ostateczności da radę windowsowy Notatnik (choć polecamy inne rozwiązania, jeśli używasz Windowsa, to np. Notepad++, VSCode; jeśli używasz Linuksa, to spokojnie da radę dostarczany z dystrybucją gEdit lub Kate; jeśli używasz takiego edytora na co dzień, to sam wiesz, z czego skorzystać).
7. Wypełnij znaczniki w sekcji na początku:
   • title -- tytuł posta
   • tags -- dowolnie wybrane tagi, pojedyncze słowa kojarzące się z tym, o czym jest post
   • layout -- pozostaw post
   • image -- link do obrazka, uwaga -- musi być hostowany na zewnętrznym serwerze lub wgrany do Githuba, instrukcja, jak wgrać obrazek do Githuba poniżej
8. Zastąp treść posta, który skopiowałeś, swoją treścią. Formatowanie odbywa się w języku Markdown. Instrukcję, jak używać języka Markdown, znajdziesz łatwo w internecie.
9. Jeśli chcesz dodać obrazek:
   • przejdź do repozytorium homepage linkami nad wyświetloną zawartością
   • przejdź do katalogu assets i dalej images
   • wybierz Add file, Upload files
   • wybierz choose your files i wybierz plik obrazka z dysku
   • opcjonalnie można w polach pod Commit changes wpisać opis wykonywanej czynności np. "dodanie obrazka z XYZ na potrzeby wpisu na blogu o ABC"
   • wybierz Commit changes
   • zostaniesz przekierowany do strony głównej repozytorium
   • aby uzyskać link do obrazka, ponownie wejdź do katalogu assets i dalej images, następnie wejdź w nazwę wgranego pliku z obrazkiem
   • kliknij prawym przyciskiem na obrazek i wybierz Kopiuj adres obrazu
   • jeśli to ma być główny obrazek posta, wklej skopiowany link do znacznika image w sekcji na początku
   • jeśli chcesz wstawić obrazek w środku treści, użyj składni języka Markdown: ![opis obrazka](link do obrazka)
10. Ponownie przejdź do repozytorium homepage (np. linkami nad wyświetlaną zawartością), do katalogu posts
11. Wybierz Add file, Create new file
12. W polu Name your file... wpisz nazwę pliku -- warto trzymać się przyjętego schematu, czyli data w formacie RRRR-MM-DD, następnie znak -, następnie tytuł wpisu małymi literami, bez polskich znaków, ze spacjami zamienionymi na znak - i na końcu rozszerzenie .md (od jezyka Markdown)
13. W polu Enter file contents here wklej z edytora przygotowany post
14. Po przejściu na zakładkę Preview możesz zobaczyć, jak w przybliżeniu twój post będzie się wyświetlał
15. Wybierz Commit changes...
16. W polach Commit message i Extended description warto wpisać opis wykonywanej czynności np. "Dodanie wpisu na blogu o XYZ"
17. Wybierz Commit changes
18. Po klikunastu minutach wpis pojawi się na stronie

jak masz problem lub pomysł jak poprawić tą instrukcję, daj znać