Criação de uma nova página

Saiba como criar uma nova página de documentação. Neste tópico, você encontrará instruções para criar os metadados iniciais da página e adicionar a página ao sumário do guia.

Criar página

1. Acesse o diretório do capítulo. Por exemplo, se você deseja criar uma nova página na seção “Segurança”, acesse o diretório latest/ug/security.

2. Determine o ID da página. De acordo com a convenção, o ID da página é todo em letras minúsculas e segmentado por -. O ID desta página é create-page.

3. Crie um novo arquivo com o ID da página e a extensão adoc. Por exemplo, .create-page.adoc

4. Insira os metadados da página usando este modelo:

 include::../attributes.txt[]

 [.topic]
 [#unique-page-id]
 = Page title
 :info_titleabbrev: Short title

 [abstract]
 --
 Brief summary of the page's content.
 --

 Introduction paragraph goes here.

Adicionar página à navegação

1. Acesse a página principal. A página principal das seções de nível superior é book.adoc.

2. Na parte inferior da página principal, inclua a página secundária.

   include::${filename}[leveloffset=+1]

   Por exemplo:

   include::create-page.adoc[leveloffset=+1]