org-tutorials/orgtutorial_dto-pt.org

   1 #+OPTIONS:    H:3 num:nil toc:t \n:nil ::t |:t ^:t -:t f:t *:t tex:t d:(HIDE) tags:not-in-toc
   2 #+STARTUP:    align fold nodlcheck hidestars oddeven lognotestate
   3 #+SEQ_TODO:   TODO(t) INPROGRESS(i) WAITING(w@) | DONE(d) CANCELED(c@)
   4 #+TAGS:       Write(w) Update(u) Fix(f) Check(c)
   5 #+TITLE:      David O'Toole Org tutorial (Traduzido para o Português)
   6 #+AUTHOR:     Ricardo Cosme
   7 #+EMAIL:      r AT cosme DOT im
   8 #+LANGUAGE:   pt
   9 #+PRIORITIES: A C B
  10 #+CATEGORY:   worg
  11
  12 # This file is the default header for new Org files in Worg.  Feel free
  13 # to tailor it to your needs.
  14
  15 Este documento é uma tradução para o Português por Ricardo Cosme do
  16 [[file:orgtutorial_dto.org][tutorial original]] de David O'Toole.
  17
  18 [[file:../index.org][{Voltar para Worg}]]
  19
  20 * Introdução
  21
  22 Org-mode é um gerenciador de informação pessoal e uma ferramenta de
  23 outlining[fn:1] para o Emacs. O objetivo deste documento é introduzir
  24 o leitor no uso do org-mode ensinando o básico através de um
  25 passo-a-passo acompanhado de imagens. A ideia aqui não é substituir o
  26 [[https://orgmode.org/org.html][manual]]. Somente uma parte das funcionalidades são apresentadas.
  27
  28 Este tutorial foi traduzido para o [[file:orgtutorial_dto-fr.org][Francês]], [[file:orgtutorial_dto-es.org][Espanhol]], [[http://hpcgi1.nifty.com/spen/index.cgi%3FOrgMode%2fOrgTutorial][Japonês]],
  29 [[http://hokmen.chan.googlepages.com/OrgTutorial.en-cn.html][Chinês]], e [[http://jmjeong.com/index.php?display=Emacs/OrgMode"][Coreano]]. Agradecimentos especiais aos tradutores.
  30
  31 ** Obtendo org-mode
  32
  33 Org-mode faz parte do Emacs 22 e 23, sendo assim se você tem uma
  34 versão moderna do Emacs, você já o tem.
  35
  36 Caso contrário você pode obtê-lo em [[https://orgmode.org/][org-mode home page]], descompactá-lo
  37 e configurar o load path do Emacs para o diretório lisp do pacote
  38 extraído:
  39
  40 : (add-to-list 'load-path "PATH_TO_WHERE_YOU_UNPACKED_ORGMODE/lisp")
  41
  42 ** Ativação
  43
  44 Adicione o seguinte ao seu .emacs:
  45
  46 : (require 'org)
  47 : (define-key global-map "\C-cl" 'org-store-link)
  48 : (define-key global-map "\C-ca" 'org-agenda)
  49 : (setq org-log-done t)
  50
  51 Isso vai garantir que o org foi carregado e alguns atalhos básicos de
  52 teclado foram definidos. Nós iremos ver adiante neste documento o que
  53 "org-store-link" e "org-agenda" fazem.
  54
  55 Mais uma coisa---é melhor configurar à parte um diretório específico
  56 onde os seus arquivos org serão armazenados. Eu recomendo usar ~/org.
  57
  58 * O básico
  59
  60 Esta seção ilustra um uso básico mostrando o que eu usei do org-mode
  61 para criar este documento.
  62
  63 ** Criando um novo arquivo
  64
  65 Se você configurou o seu arquivo de inicialização do Emacs conforme
  66 sugeri acima, o Emacs deveria entrar no org-mode sempre que você
  67 visitar ou criar um arquivo com a extensão ".org".
  68
  69 Eu criei um novo arquivo chamado "OrgTutorial.org" e vi o indicador
  70 "Org" no modeline, indicando assim que nós entramos no org-mode.
  71
  72 ** Uma simples lista de tarefas
  73
  74 Primeiramente eu entrei com um *headline* chamado "Tasks" para
  75 armazenar tarefas. Isso não é necessário porém normalmente é
  76 conveniente, especialmente quando você quer manter tarefas separadas
  77 do corpo do documento que você está escrevendo.
  78
  79 Headlines de primeiro nível começam com uma estrela; segundo nível
  80 começam com duas estrelas e assim por diante.
  81
  82 No org-mode, itens TODO são sempre headlines. Eu entrei com um item
  83 TODO para "Start new org file for tutorial."
  84
  85 file:../images/dto/tutorial-1.png
  86
  87 Isso é um pouco bobo, porque eu já comecei o novo arquivo. Sendo
  88 assim, vamos marcar o item TODO como DONE movendo o cursor para a
  89 linha do item e entrando com *C-c C-t*, que executará o comando
  90 *org-todo*.
  91
  92 Aqui está o resultado:
  93
  94 file:../images/dto/tutorial-2.png
  95
  96 Note como o org-mode usa um timestamp para registrar quando o item
  97 TODO foi fechado.
  98
  99 Vamos adicionar mais alguns itens TODO. Posicione o cursor na próxima
 100 linha e entre com *M-shift-RET* para chamar
 101 *org-insert-todo-heading*. Você pode entrar com o comando quantas
 102 vezes quiser para adicionar TODOs.
 103
 104 file:../images/dto/tutorial-3.png
 105
 106
 107 ** Usando headlines para estruturar o documento
 108
 109 Normalmente a melhor forma de organizar as suas ideias é montar um
 110 outline[fn:1]. Meu próximo passo é planejar os tópicos do
 111 tutorial. Fazendo isso você quebra a inércia intimidadora da página em
 112 branco em uma série de blocos menos intimidadores. Assim se torna mais
 113 fácil inserir o conteúdo.
 114
 115 Lembre-se que uma estrela começa um título de primeiro nível, e duas
 116 estrelas um título de segundo nível. Se você precisar aninhar mais, vá
 117 em frente e use três ou mais estrelas!
 118
 119 Aqui está como ficou após eu terminar o planejamento do documento:
 120
 121 file:../images/dto/tutorial-4.png
 122
 123 Note que eu marquei "Outline document" como DONE depois que eu
 124 terminei.
 125
 126 ** Preenchendo as seções
 127
 128 Você pode facilmente adicionar um texto abaixo de qualquer título.
 129
 130 file:../images/dto/tutorial-5.png
 131
 132 ** Links para outros lugares
 133
 134 Na seção "Obtaining Org-mode" eu precisei prover um link para o site
 135 do org-mode. Uma sintaxe especial com colchetes é utilizada para o link:
 136
 137 : [[link][description]]
 138
 139 Veja como eu primeiramente entrei com o link e a descrição, deixando
 140 em aberto o último colchete:
 141
 142 file:../images/dto/tutorial-6.png
 143
 144 Então quando eu entro com o último colchete, o link "colapsa" e
 145 simplesmente exibe a descrição.
 146
 147 file:../images/dto/tutorial-7.png
 148
 149 Tente mover o cursor sobre o link e pressione *C-c C-o* para executar
 150 *org-open-at-point*.
 151
 152 Você também poder fazer um link para arquivos locais. Tente visitar
 153 outro arquivo---por exemplo, o seu arquivo de inicialização do
 154 Emacs. Então entre com *C-c l* para chamar *org-store-link*. Você vai
 155 ver uma mensagem que o link foi armazenado para a posição atual no
 156 arquivo que você está visitando.
 157
 158 Então volte para o seu buffer org-mode e cole o link usando *C-c C-l*
 159 para chamar *org-insert-link*. (Você pode necessitar usar as setas
 160 para fazer scroll e procurar o link que você acabou de registrar.)
 161
 162 ** Visão geral de um documento
 163
 164 Neste momento, o meu documento está ficando longo e eu não consigo
 165 visualizá-lo por completo em uma tela. Org-mode torna fácil obter uma
 166 visão geral do seu documento pressionando *shift-TAB*.
 167
 168 file:../images/dto/tutorial-9.png
 169
 170 Note que apenas os títulos de primeiro nível são exibidos. Você pode
 171 pressionar novamente *shift-TAB* para exibir *todas* os títulos,
 172 incluindo os itens TODO:
 173
 174 file:../images/dto/tutorial-10.png
 175
 176 Então pressione novamente para exibir a visão normal deste documento,
 177 com a exibição do corpo das seções:
 178
 179 file:../images/dto/tutorial-11.png
 180
 181 ** Adicionando notas a uma tarefa
 182
 183 Você pode colocar o texto que quiser abaixo de um título de um item
 184 TODO. Na verdade, você até pode ter subtítulos abaixo de um TODO, e
 185 TODOs dentro de TODOs!
 186
 187 Fazer anotações nas tarefas torna mais fácil o processo de coletar
 188 links e pensamentos relacionados. Aninhar tarefas é ótimo para modelar
 189 o fluxo de trabalho---muitas vezes, uma tarefa grande é quebrada em
 190 subtarefas menores que você pode finalizar assim que são concluídas.
 191
 192 * Uma amostra de recursos avançados
 193
 194 Antes de terminarmos, nós vamos passar rapidamente pela lista global
 195 de TODOs, agendamento, e recursos da agenda. Esses recursos são
 196 utilizados para se combinar itens de TODO relevantes que estão em
 197 arquivos org distintos em uma visão por priorização e cronologia. Você
 198 também pode ver quais tarefas foram completadas e quando.
 199
 200 ** Configuração
 201
 202 Primeiramente você deve configurar a variável *org-agenda-files* para
 203 que o org-mode conheça quais arquivos buscar por TODOs e itens
 204 agendados.
 205
 206 Vamos imaginar que você já tenha diversos arquivos org---digamos, um
 207 para o trabalho, outro para casa, e um outro para a escola.
 208
 209 Então você adiciona o seguinte ao seu arquivo de inicialização do Emacs:
 210
 211 : (setq org-agenda-files (list "~/org/work.org"
 212 :                              "~/org/school.org"
 213 :                              "~/org/home.org"))
 214
 215 ** Lista global de TODO
 216
 217 Pressione *C-c a t* para entrar no lista global TODO. Org-mode vai
 218 procurar por arquivos em *org-agenda-files* e apresentar uma lista de
 219 todos os itens de TODO em aberto:
 220
 221 file:../images/dto/tutorial-16.png
 222
 223 Você pode mover o cursor para um item de TODO diferente, e pressionar
 224 "t" para marcar o item como DONE, ou pressionar *RET* para entrar no
 225 arquivo onde o TODO está localizado.
 226
 227 ** Agendamento de tarefas usando a agenda
 228
 229 Vamos dizer que eu queira agendar "Finish document" para hoje. Eu movo
 230 o cursor para a linha depois do item de TODO "Finish document", e
 231 pressiono *C-c C-s* para executar *org-schedule*. A agenda se abre, e
 232 eu posso entrar com uma data ou clicar na data desejada:
 233
 234 file:../images/dto/tutorial-12.png
 235
 236 Uma vez selecionada a data, org-mode insere um timestamp de
 237 agendamento depois do item de TODO:
 238
 239 file:../images/dto/tutorial-13.png
 240
 241 Agora salve o arquivo, e pressione *C-c a a* para *org-agenda*. Uma
 242 visão do itens agendados para a semana será exibida:
 243
 244 file:../images/dto/tutorial-14.png
 245
 246 Agora pressiona "l" (letra minúscula L) para ativar a visão log. Isso
 247 exibe todas as tarefas terminadas e o momento em que foram concluídas.
 248
 249 file:../images/dto/tutorial-15.png
 250
 251 * Até mais
 252
 253 Este documento é somente uma breve navegação pelo org-mode. Há mais
 254 esperando por você em [[https://orgmode.org/manual/index.html][online org-mode manual]].
 255
 256 * Footnotes
 257
 258 [fn:1] "Outline" é um termo em inglês que denota o planejamento de um
 259 documento através de um esqueleto a ser preenchido durante o
 260 desenvolvimento do mesmo. Estabelecer as seções do documento é uma
 261 forma de outline.