2022/08/12

content/Optymalizacja/Narzędzia/Narzędzia.md

@@ -53,4 +53,5 @@ title: Narzędzia
 - [[Optymalizacja/Narzędzia/Digital Ocean]]
 - [[Optymalizacja/Narzędzia/Session]]
 - [[Optymalizacja/Narzędzia/Rize]]
-- [[Optymalizacja/Narzędzia/Intellij]]
+- [[Optymalizacja/Narzędzia/Intellij]]
+- [[Optymalizacja/Narzędzia/Obsidian]]

content/Optymalizacja/Narzędzia/Obsidian.md

@@ -0,0 +1,50 @@
+---
+title: Obsidian
+---
+
+## Czym jest Obsidian?
+Najprościej mówiąc to aplikacja do notowania. Jej głównymi zaletami jest fakt, że pracuje na lokalnych plikach [[markdown]] oraz umożliwia połączenia między notatkami poprzez tzw. "wiki links". Na ich podstawie może budować mapy treści. 
+
+## Jak wykorzystuję Obsidian? 
+Wyłącznie w jednym celu: rozwijania tego projektu, czyli tzw. Digital Garden. Z pomocą projektu [Quartz](https://quartz.jzhao.xyz/) (opartego o framework Hugo) publikuję te notatki w domenie brain.overment.com. 
+
+### Zasady
+Pomimo tego, że zapoznałem się z więkością materiałów od osób takich jak Tiago Forte, tak jednocześnie większość zasad rozwoju notatek w Obsidianie opracowałem samodzielnie. Według mnie Tiago świetnie organizuje temat ale jego system jest dla mnie zbyt złożony. Z pewnością pod wieloma względami się różnimy, więc mój proces musiał zostać dopasowany do mnie. 
+
+**Zasady to:** 
+- Gdy o czymś piszę i pada słowo kluczowe na temat którego chcę powiedzieć więcej, oznaczam je linkiem. 
+- Stosuję prostą organizację katalogów, czyli:
+	- Fundamenty - moje podstawy funkcjonowania
+	- Optymalizacja - moje techniki optymalizacji
+	- Wiedza - to, co wiem
+	- i Projekty - to, co robię
+- W przypadku gdy widzę, że jakiś temat uwzględnia wiele powiązanych ze sobą zagadnień tworzę notatkę zbiorczą, stanowiącą zbiór lików do wszystkich tematów. Według m.in. Tiago, to tzw. ToC - Table of Contents.
+- Tworzę treści o tym, co chcę eksplorować lub o tym, co jest dla mnie w danej chwili ważne. Często wyzwalaczem jest sytuacja w której ktoś zadaje mi pytanie a ja widzę, że powtarza się ono często, więc lepiej będzie napisać o nim notatkę zamiast odpowiadać indywidualnie. 
+
+i to wszystko. Nie ma nic poza tym. 
+
+### Automatyzacja
+Do pracy z Obsidianem wykorzystuję [[Optymalizacja/Narzędzia/Keyboard Maestro]] oraz moje makra [[Projekty/Design Maestro]]. Umożliwiają mi one przede wszystkim: 
+
+- szybkie otwieranie wybranych notatek (x-scheme-url np. obsidian://open?vault=content&file=_index)
+- szybkie dodawanie treści (Keyboard Maestro, akcja Append text to a File)
+- dopisywanie linków do bardzo popularnych tematów (jak wyżej)
+- wprowadzanie globalnych zmian do notatek (z pomcą [[Regex]])
+- aktualizacje metadanych (np. czasu ostatniej edycji pliku interpretowanej przez Quartz)
+- szablonów dodawania notatek (text expander)
+
+Przykład wykorzystania Deisgn Maestro - szybkie dodawanie nowych narzędzi. Wykonanie tego makro dodaje narzędzie do listy ToC oraz tworzy nową notatkę. Do schowka trafia link do niej, dzięki czemu w razie potrzeby mogę bardzo szybko otworzyć Obsidiana a jeżeli nie ma takiej potrzeby, nie muszę się odrywać od aktualnie wykonywanego zadania: 
+![](https://space.overment.com/Screen-Shot-2022-08-12-14-11-53-xmPJB/Screen-Shot-2022-08-12-14-11-53.png)
+Powyższe makro nie jest częscią [[Projekty/Design Maestro]] i zostało przygotowane na moje potrzeby. Analogiczne makra mam dla Książek, Automatyzacji czy Modeli Mentalnych.
+### Publikacja notatek
+Mój `vault` jest jednocześnie repozytorium [[Wiedza/Programowanie/git/git]]. Oznacza to, że moje notatki przechowywane są nie tylko lokalnie na moim komputerze ale także we wspomnianym repozytorium. 
+
+Jednocześnie `vault` umieszczony jest wewnątrz wspomnianej aplikacji przygotowanej na podstawie projektu Quartz, z pomocą której generuję strony HTML oraz publikuję je na brain.overment.com z pomocą automatyzacji [[Github Actions]]. 
+
+Proces konfiguracji Quartz szczegółowo pokazałem na filmie dostępnym na [[Projekty/Ahoy!]] [Czytaj wpis](https://community.ahoy.so/c/nocode-podziel-sie-wiedza/publikacja-notatek-na-obsidian-z-quartz-na-github-pages) oraz jest on również dość szczegółowo opisany na stronie projektu Quartz, przy czym sam zastosowałem jeszcze kilka własnych modyfikacji. O części z nich wspominam na filmie a nad niektórymi nadal pracuję. 
+
+Co ciekawe aktualizacje odbywają się w 100% automatycznie, ponieważ w chwili zamknięcia Obsidiana, makro Keyboard Maestro zostaje uruchomione i: 
+- dodaje zmiany do repozytorium
+- wysyła je do zdalnego repozytorium
+- przesłanie danych uruchamia [[Github Actions]] i tym samym publikuje notatki
+