diff --git a/README.org b/README.org index 17db502..4a7ee9f 100644 --- a/README.org +++ b/README.org @@ -11,11 +11,22 @@ O objetivo a longo prazo é incluir uma suíte completa de configurações, com * Anotações com org-mode -O org-mode é uma extensão muito popular para o Emacs. É o principal motivo pelo qual muitas pessoas não ligadas à programação ou computação fazem uso frequente do Emacs, tanto para fins pessoas quanto fins acadêmicos. +O org-mode é uma extensão muito popular para o Emacs. É o principal motivo +pelo qual muitas pessoas não ligadas à programação ou computação fazem uso +frequente do Emacs, tanto para fins pessoas quanto fins acadêmicos. -Em termos simples, o org-mode é uma linguagem de marcação, editoração, ou markup, feita para organização pessoal. Ele possibilita a criação de listas de afazeres, entradas de agenda, e outras formas de anotação pessoal, mas também permite a exportação destas anotações para documentos completos, usando uma conversão pelo LaTeX. Isto torna o org-mode uma ferramenta de alta utilidade: tem a simplicidade de uma linguagem básica como Markdown, mas todas as capacidades de uma linguagem completa como LaTeX. +Em termos simples, o org-mode é uma linguagem de marcação, editoração, ou +markup, feita para organização pessoal. Ele possibilita a criação de +listas de afazeres, entradas de agenda, e outras formas de anotação pessoal, +mas também permite a exportação destas anotações para documentos completos, +usando uma conversão pelo LaTeX. Isto torna o org-mode uma ferramenta de +alta utilidade: tem a simplicidade de uma linguagem básica como Markdown, +mas todas as capacidades de uma linguagem completa como LaTeX. -O org-mode suporta exportação para vários formatos além de LaTeX, incluindo Markdown e HTML, e pode ser usado até para criação de páginas da web. Esta documentação está escrita em org, e assim recebe a formatação adequada na página do git do Emacs Humanities. +O org-mode suporta exportação para vários formatos além de LaTeX, incluindo +Markdown e HTML, e pode ser usado até para criação de páginas da web. +Esta documentação está escrita em org, e assim recebe a formatação adequada +na página do git do Emacs Humanities. ** Guia rápido de org-mode @@ -69,6 +80,57 @@ Vale notar que as vírgulas no início das linhas não são presentes no org nor #+end_src + +Abaixo está o mesmo texto em org do bloco acima, porém exibido corretamente: +*** Títulos (chamados headings) se denotam com um asterisco. +**** Dois asteriscos indicam um subtítulo (subheading). +***** Três asteriscos indicam um subsubtítulo. +***** e assim vai... +****** Existem níveis infinitos de subsubsubsubs...títulos. + + Títulos podem conter texto dentro de si. + +***** Texto! + + Para inserir texto, basta apenas... inserir texto. Nada de tags de

ou qualquer coisa. + + Para separar dois blocos de texto em parágrafos, apenas inclua uma linha vazia entre os dois. + + Podemos também fazer algumas formatações básicas, como *negrito*, /itálico/, =realçado=, etc. + + - Fazer listas também é fácil, basta usar um hífen seguido por um espaço logo ao início da linha, antes do texto + - Outro item de exemplo + - Listas também suportam sub-itens, que são indicados por um espaço antes do hífen do início + - outro subitem + - [ ] As listas também podem ser /checklists/, se possuírem colchetes separados por um espaço no início + - [-] As checklists são interativas. Elas se relacionam com seus subitens. + - [X] Subitem completo. Este é marcado por um X entre os colchetes. Para facilitar, não é necessário inserir o X manualmente. Há uma tecla de atalho para isso, C-c C-c, que torna a ação mais rápida. + - [ ] Subitem incompleto. Este marca o item acima com o sinal de compleção parcial, o hífen. + + + + 1. Pode-se fazer listas numeradas também, usando um número e um ponto. + 2. Outro item numerado + + 1) Há outro formato para listas numeradas também, usando um parêntese. + 2) Listas numeradas não suportam + +** Mapas mentais com org-roam + +O org-roam é uma extensão do org-mode centrada na interligação de arquivos +relacionados, inspirada pelo Roam Research e pelo método Zettelkasten. +A ideia é permitir ao usuário criar um verdadeiro cérebro externo, com toda +a riqueza de informação de seu cérebro real. + +Com o org-roam-server, é possível navegar os arquivos do org-roam por um +gráfico renderizado em tempo real, exibido no seu navegador de internet, +e conectado ao org-roam pelo org-roam-protocol. + +Um gif demonstrando o uso do org-roam-server para navegação de arquivos +interligados: + +[[file:docs/org-roam-server.gif]] +* Para ** Por onde começar O Emacs já vem com um tutorial em si, que contém informações básicas sobre conceitos, teclas de atalho e outras dicas de uso do editor. O tutorial pode ser acessado pressionando C-h t (isto é, as teclas Control+h, seguidas pela tecla t) ou chamando a função help-with-tutorial pelo menu de execução de funções, acessado pelas teclas M-x (isto é, Alt+x). diff --git a/docs/org-roam-server.gif b/docs/org-roam-server.gif new file mode 100644 index 0000000..4c180f0 Binary files /dev/null and b/docs/org-roam-server.gif differ