O Obsidian é um software de base de conhecimento pessoal que funciona como um segundo cérebro. Sua função é registrar notas que podem ter um relacionamentos para facilitar a organização de idéias.

Além de notas em markdown¹, existem plugins com funcionalidades como Canvas, Excalidraw, Kanban e outros recursos alimentados pela comunidade.

O software opera a partir de uma pasta de documentos textos no formato markdown, a qual, dentro do Obsidian se chama cofre e pode ser totalmente customizado pelo usuário (acesso total ao código).

Cada nova anotação criada no Obsidian gera um documento “.md” e o conteúdo pode ser relacionado com notas existentes, o que auxilia o motor de busca interno da ferramenta a encontrar as notas de forma mais rápida. Também existe a possibilidade de criar tags.

Depois de começar a alimentar o cofre, uma visão gráfica igual aos exemplos abaixo tornam-se disponíveis para consultar o relacionamentos:

É possível utilizar ferramentas como Dropbox, Onedrive e Icloud para salvar os arquivos, mas com isso você perde o principal recurso do Git, que é o versionamento.

É possível sincronizar estes arquivos com o Iphone sem nenhum custo utilizando o Github.

Vamos lá?

Tutorial

Na estação de trabalho

Vamos considerar que o Obsidian já está instalado e com o cofre criado em sua estação de trabalho

Existe a opção de sincronismo utilizando o próprio Obsidian, mas para isso é preciso ter uma conta cadastrada e arcar com um custo para utilizar o recurso de sincronismo entre dispositivos. Vou mostrar como podemos utilizar um repositório privado no Github para fazer esta função de graça no seu Iphone ou Android.

Mostro neste post somente como fazer no Iphone, mas o conceito é o mesmo para Android.

Instalar plugin do Git

Primeiro precisamos instalar o plugin não nativo do git no Obsidian, Clique em Plugins não oficiais e depois em Procurar

Digite Git no ponto 1 e depois no ponto 2 clique para Instalar o plugin do Git

Após instalar o aplicativo será preciso criar um repositório privado no Github e fazer um clone em sua estação de trabalho utilizando os seguintes comandos via terminal:

1
git clone https://[github]/projeto

Vamos considerar daqui, o diretório do cofre do Obsidian já versionado com um repositório privado em uma conta do Github.

Após versionado, qualquer mudança no Obsidian é indicado no canto inferior direto, conforme a imagem abaixo:

Tente não esquecer de subir todas as mudanças importantes para o repositório utilizando os conceitos de versionamento;

Fluxo de versionamento Git

O fluxo correto para não esquecer de subir as versões corretamente está logo abaixo:

flowchart LR
  A[Abrir Obsidian] --> B[Git: Pull]
  B --> C[mudanças]
  C --> D[Git: Commit All changes]
  D --> E[Git: Push]
  E --> F[Fechar Solution]

Até este momento, o Obsidian deve estar vinculado ao projeto privado da sua conta no Github

Agora seguiremos com a parte principal deste post, que é como Acessar este repositório no github utilizando aplicativos sem custo do Iphone.

Vamos lá?

No Iphone

Instalação do Obsidian

Primeiro instale o aplicativo Obsidian, disponível em sua Apple Store e escolha o Icloud para armazenar o cofre. Ao escolher o Icloud uma pasta do Obsidian será criada no repositório do Icloud conforme a imagem abaixo:

Instalação do ISH (terminal)

Depois instale o aplicativo ISH, ele é um terminal linux na distribuição mais leve chamada Alpine, também disponível na Apple Store.

Ao abrir o app ISH, execute os comandos abaixo no terminal linux Alpine para atualizar o repositório.

1
apk update

Instalação do git no ISH

Agora instale o git no diretório apartado do ISH

1
apk add git

Vínculo do repositório obsidian com o Icloud

Vá ao diretório raiz

1
cd /

Crie uma pasta do obsidian na raíz

1
mkdir obsidian

Agora vem o pulo do gato que é montar o repositório do Icloud na pasta do obsidian criada anteriormente no ponto de montagem “/obsidian”.

1
mount -t ios . obsidian

Ao executar o último comando, o aplicativo vai abrir o app Arquivos em background e vai pedir para você escolher uma pasta diretamente para ser o ponto de montagem da pasta obsidian. É nesta pasta que você precisa escolher o diretório Obsidian no Icloud e clicar em Abrir.

Abra o aplicativo do github e copie o endereço do projeto

Vá na pasta do obsidian

1
cd \obsidian

Agora faça o clone do projeto

1
git clone https://[github]/projeto

Despois de digitar a senha, um clone do projeto será baixado para o diretório \obsidian que é praticamente um link até a pasta do Obsidian de dentro do Icloud. Esta é a mágica para conseguir sincronizar o repositório e fazer o Obsidian funcionar no celular.

Digite o seu usuário do Github e a senha que podem ser feitas de várias formas (chave gpg, chave pública e privada). Escolha a forma de autenticar em seus projetos no Github.

Ao terminar, fica 100%

Com isso, o repositório já está em seu celular, especificamente na pasta do Obsidian ocupando o espaço de sua conta no Icloud. Abra o aplicativo Obsidian e veja se está com o conteúdo do seu cofre.

Depois, você pode configurar usuário e senha dentro do plugin do Obsidian para não precisar executar os comandos do terminal, podendo utilizar os comandos git de dentro do próprio obsidian, conforme as imagens abaixo:

Clique na Engrenagem principal do Obsidian e vá no plugin Git

Preencha as informações de conta e senha conforme a imagem abaixo:

Agora você pode utilizar a opção de dentro do Obsidian para disparar os comandos Git

Gostou da dica?

Lembre-se de respeitar o fluxo correto para um bom funcionamento do versionamento utilizando conceitos Git.

flowchart LR
  A[Abrir Obsidian] --> B[Git: Pull]
  B --> C[mudanças]
  C --> D[Git: Commit All changes]
  D --> E[Git: Push]
  E --> F[Fechar Solution]

Legal a dica, né?

Comente abaixo caso tenha alguma dúvida!!

Referência