salesagility / SuiteDocs

SuiteCRM - Open source CRM for the world
https://docs.suitecrm.com/
Other
60 stars 285 forks source link

Automatic section numbering #601

Open likhobory opened 1 year ago

likhobory commented 1 year ago

What is wrong, less clear, or missing

In some recently created docs sections are numbered manually.

Proposed fixes and/or additions

I propose to turn on automatic sections numbering, which will simplify the sections numbering for the new documents and will avoid some errors. Instead of the default numbering setting (sectionNumbers = true) we can use the soft attribute setting by adding these lines to the Hugo config.toml file:

[markup]
   [markup.asciidocExt]
     #sectionNumbers = true
     [markup.asciidocExt.attributes]
        sectnums = "@"

In this case, if necessary, it will be possible to disable automatic numbering in certain files, for example, in _index... files.