English Portuguese (Brazil)
Chapter 2. Tools
Tools Ferramentas
Several software tools are used to manage the FreeBSD documentation and render it to different output formats. Some of these tools are required and must be installed before working through the examples in the following chapters. Some are optional, adding capabilities or making the job of creating documentation less demanding. Várias ferramentas são utilizadas para gerenciar a documentação do FreeBSD e renderizá-la para diferentes formatos. Algumas dessas ferramentas são necessárias e devem ser instaladas antes de trabalhar com os exemplos nos capítulos a seguir. Algumas são opcionais, adicionando recursos ou tornando a tarefa de criar documentação mais simples.
Required Tools Ferramentas Obrigatórias
Install `gohugo` and `rubygem-asciidoctor` as shown in <<overview,the overview chapter>> from the Ports Collection. These applications are required to do useful work with the FreeBSD documentation. Some further notes on particular components are given below.
Optional Tools Ferramentas Opcionais
These applications are not required, but can make working on the documentation easier or add capabilities. Essas ferramentas não são necessárias, mas podem facilitar o trabalho na documentação ou adicionar recursos.
Software Software
Vim (package:editors/vim[])
A popular editor for working with AsciiDoctor.
Emacs (package:editors/emacs[])
Both of these editors include a special mode for editing documents. This mode includes commands to reduce the amount of typing needed, and help reduce the possibility of errors.