Kompletný sprievodca: Ako nainštalovať Obsidian a Termux na Android a spravovať poznámky cez git¶
Synchronizácia poznámok medzi mobilným telefónom a vzdialeným repozitárom pomocou gitu a Termuxu je jedným z najefektívnejších spôsobov, ako mať plnú kontrolu nad svojimi dátami bez závislosti od platených cloudových služieb.
V tomto návode si ukážeme, ako správne nastaviť Obsidian, Termux a git na Androide tak, aby vaše poznámky zostali vždy bezpečne synchronizované a pripravené na prácu.
1. Inštalácia Termuxu¶
Termux premení váš mobil na linuxovú konzolu. Možno si poviete, že toto je trošku hardcore. Ale ak sa dopracujete na koniec návodu, tak zistíte, že ide iba o prvotnú konfiguráciu a po tomto už funguje synchronizácia na jeden klik.
Aby mal Termux správne oprávnenia pre prácu so súbormi a úložiskom zariadenia, inštalujte výhradne verziu z F-Droidu (z dôvodu zmien v pravidlách prístupu k úložisku v obchode Google Play).
- Termux (F-Droid): Stiahnuť Termux z F-Droid
- Doplnky (voliteľné): Pre spúšťanie skriptov z plochy odporúčam nainštalovať aj Termux:Widget (F-Droid) a Termux:API (F-Droid).
- Tasker integrácia: Pre pokročilú automatizáciu môžete využiť Tasker (Google Play) spolu s pluginom Termux:Tasker Wiki.
Po prvom spustení Termuxu aktualizujte balíčky a nainštalujte potrebné balíky nástrojov:
# spustit v aplikacii Termux na mobile
pkg update
pkg upgrade
# Základné vývojové a systémové nástroje
# obsidian + git + termux
pkg install git vim make libacl tree
pkg install termux-tools termux-services
# https://f-droid.org/en/packages/com.termux.widget
# https://f-droid.org/en/packages/com.termux.api
pkg install termux-api
Aby ste nemuseli všetky hore uvedené príkazy prácne prepisovať na mobile, nainštalujte si na telefón ssh:
pkg add openssh
2. Klonovanie repozitára¶
Pred nastavením gitu musíte Termuxu povoliť prístup k internému úložisku zariadenia. Podrobné informácie o vzdialenom prístupe nájdete aj na Termux Remote Access Wiki.
Klonovanie Obsidian vaultu¶
Použijeme oddelenie git adresára (GIT_DIR) a pracovného stromu (GIT_WORK_TREE). Toto je dôležité spraviť, aby sme sa vyhli chybe s poškodzovaním git repozitára (podivná chyba pri kombinácii git + Android + typ súborového systému)
cd /storage/emulated/0/Documents
GIT_DIR=~/.git-moj-obsidian GIT_WORK_TREE=~/moj-obsidian git clone https://xxx:xxx@github.com/moj-obsidian
mv ~/moj-obsidian /storage/emulated/0/Documents/moj-obsidian
cd ~ && ln -s /storage/emulated/0/Documents/moj-obsidian moj-obsidian
3. Konfigurácia gitu¶
Na mobilnom zariadení nie je potrebné verzovať pracovné plochy a dočasný kôš aplikácie Obsidian:
cd ~/moj-obsidian
# Nastavenie .gitignore pre špecifické súbory Obsidianu
echo .trash/ >> .gitignore
echo .obsidian/workspace.json >> .gitignore
echo .obsidian/workspace-mobile.json >> .gitignore
Ďalej nastavíme správanie gitu - ja osobne preferujem rebase pred merge, pretože história zmien sa potom číta jednoduchšie.
Takto to používam ja:
# Globálna konfigurácia gitu
git config --global push.autoSetupRemote true
git config --global init.defaultBranch main
git config --global pull.rebase true
git config --global rebase.autoStash true
Toto si nastavte podľa seba:
A ešte označte priečinky za bezpečné:
git config --global --add safe.directory /storage/emulated/0/Documents/moj-obsidian
git config --global --add safe.directory /storage/emulated/0/Documents/obsidian-aikido
4. Automatizácia prostredia a spúšťacie skripty¶
Pre pohodlnú prácu z terminálu si nastavíme skratky (aliasy) v .bashrc a vytvoríme spúšťacie skripty pre Termux Widget.
Nastavenie ~/.bashrc¶
Pridajte skratky na správu vášho vaultu a nastavenie vizuálneho promptu pomocou Liquid Prompt:
# Inštalácia Liquid Prompt
pkg install ncurses-utils -y
git clone https://github.com/liquidprompt/liquidprompt.git ~/liquidprompt
# Konfigurácia ~/.bashrc
cat > ~/.bashrc <<'EOF'
alias m='export GIT_DIR=~/.git-moj-obsidian; export GIT_WORK_TREE=~/moj-obsidian; make -C ~/moj-obsidian'
alias a='export GIT_DIR=~/.git-obsidian-aikido; export GIT_WORK_TREE=~/obsidian-aikido; make -C ~/obsidian-aikido'
export EDITOR=vim
export GIT_DIR=~/.git-moj-obsidian
export GIT_WORK_TREE=~/moj-obsidian
# Načítanie Liquid Prompt iba v interaktívnom režime
[[ $- = *i* ]] && source ~/liquidprompt/liquidprompt
EOF
Vytvorenie skratiek pre Termux:Widget¶
Tieto skripty vám umožnia synchronizovať Obsidian jedným kliknutím priamo z plochy telefónu:
mkdir -p ~/.shortcuts
# Skript pre synchronizáciu
cat <<'EOF' > ~/.shortcuts/sync-obsidian.sh
#!/bin/bash
. ~/.bashrc
GIT_DIR=~/.git-moj-obsidian GIT_WORK_TREE=~/moj-obsidian make -C ~/moj-obsidian
read press_keyboard
EOF
chmod 755 ~/.shortcuts/sync-obsidian.sh
# Skript pre kontrolu stavu repozitára
echo -e '#!/bin/bash\n\ncd ~/moj-obsidian && git status; read press_keyboard' > ~/.shortcuts/git-status.sh
chmod 755 ~/.shortcuts/git-status.sh
Aby to začalo celé fungovať, potrebujeme ešte do nášho vaultu pridať pár shell skriptov a
Makefile.