…np. po tym gdy nadejdzie ponaglenie z Github, że coś muszę uaktualnić. 2023-01-07 - dodatek: Giscus - komentarze w Jekyll

Po ponagleniu o konieczności uaktualnienia można np. wykonać synchronizację lokalnej kopii. Następnie w dowolnym wybranym blogu:

Zmiana na wyższą wersję Ruby

  1. W przypadku zmiany numeru głównego wersji X.Y. na nowszy: instalacja Ruby w nowym miejscu; MSYS2 basic; ścieżka w PATH do nowego Ruby pojawi się najwyżej (będzie ważniejsza od starszych) .
    Natomiast w przypadku uakt. podwersji X.Y. Z - tylko aktualizacja, bez miany foldera i bez DevKit. Potem jest pytanie co z MSYS2 - [2], tj. uaktualnienie działa choć rzuca błędami; może warto dawać [1], tj. nowa instalacja MSYS2.
  2. gem install bundler

Zmiana na wyższą wersję Jekyll

  1. https://jekyllrb.com/docs/installation/windows/ 
    gem install jekyll bundler
  2. Wymuszamy instację potrzebnych bibliotek w najnowszej wersji 
    bundle add bbbbbb

    (lub?) W gemfile dopisujemy wersję, która podlega aktualizacji, np.:

    gem "rexml", "~> 3.2"
  3. gems installed bundle exec jekyll -v
  4. Instalacja brakujących gem, a może wystarczy bundle update 
    bundle install
  5. bundle info --path minima - sprawdzanie ścieżki do szablonu
  6. UWAGA- w nazwach plików chyba nie może być nie-ascii, np. w URL. Dodanie _ przed nazwą pliku/foldera chyba powoduje ignorowanie tego podczas bundle exec jekyll serve. Dodałem _ przed *.URL i *.cmd.
  7. git commit

Uruchamianie podglądu _r.cmd:

:: ostatni człon aktulanego foldera %cd% poprzedzony http://localhost/ oraz wywołanie przeglądarki
@FOR /F "delims=|" %%i IN ("%cd%") DO (
  start "jekyll-localhost-%%~ni" http://localhost:4000/%%~ni/
  start "jekyll-www-%%~ni" https://andrzejq.github.io/%%~ni/ )
::uruchomienie lokalnego serwera www
bundle exec jekyll serve

W kolejnych blogach:

Jeśli kolejne blogi są analogiczne do uaktualnionego:

  1. Nadpisuję nowy gemfile
  2. bundle update
  3. git commit

Jeśli trzeba - instalacja szablonu “minima”

https://github.com/jekyll/minima

  1. Gemfile: (dopisz) gem "minima"
  2. bundle

Giscus - komentarze w Jekyll

  1. Repository -> Settings -> discussions enabled. ## 👋 Witaj!
    Będzie mi bardzo miło jeśli zechcesz skomentować moje wpisy.
  2. Strona “discussion” - edycja (ikona ołówka). Można usunąć zbędne kategorie i dodać nową, np. Title: “Komentarze” ; Description: “Komentarze gości” ; Discussion Format: (*) Annoucement. Można wybrać też ikonę dla kategorii.
  3. Dodanie Giscus https://github.com/apps/giscus do każdego repozytorium: [Configure] (*) Only select repositories - wybranych lista repozytoriów.
  4. https://giscus.app ( = Website ) - dla każdego repozytorium generujemy parametry:
    repository: “andrzejQ/El_Prog” (np.) ; Page ↔️ Discussions Mapping: (*) Discussion title contains page pathname ; Discussion Category: ;-) Komentarze ; [x] Only search for discussions in this category ; [x] Enable reactions for the main post ; [x] Wczytaj komentarze leniwie ; Theme [Preferred].
  5. Wygenerowany <script> wklejam do “El_Prog_includes\giscus_js.html”
  6. “El_Progs_includes\footer.html” (tu trzeba usunąć spację z { %) 
    ...
 { %- if page.comments == true -%}
   <p style="font-size:small"> Włącz się do dyskusji. 
   Będą zachowane te komentarze, które jakoś dotyczą treści na blogu. 
   <br> Na początek trzeba mieć (darmowe) konto na   <a href="https://github.com/">GitHub</a>.</p>
   { %- include giscus_js.html -%}
 { %- endif -%}
  7. W każdym poście inicjalny wpis (pozwala każdemu na “odpowiedz”)
    Nowa wersja komentarzy z użyciem giscus -> GitHub Discussions.