resolves #17 fix nav grouping (PR #18)

* rename first nav to nav-top.adoc
* create separate nav files for document and element attributes
* create separate nav file for breaks
* use same structure for all nav files
* put each top level item in its own list

antora.yml

@@ -8,12 +8,14 @@ asciidoc:
     listing-caption: Example@
     release-version: '2.0.12'
 nav:
-- modules/ROOT/nav.adoc
+- modules/ROOT/nav-top.adoc
 - modules/blocks/nav-basics.adoc
-- modules/attributes/nav.adoc
+- modules/attributes/nav-document.adoc
+- modules/attributes/nav-element.adoc
 - modules/document/nav.adoc
 - modules/sections/nav.adoc
 - modules/blocks/nav-paragraph.adoc
+- modules/blocks/nav-breaks.adoc
 - modules/text/nav.adoc
 - modules/lists/nav.adoc
 - modules/macros/nav.adoc

modules/attributes/nav.adoc → modules/attributes/nav-document.adoc

@@ -11,8 +11,3 @@
 ** xref:reference-attributes.adoc[]
 *** xref:unresolved-references.adoc[]
 ** xref:assignment-precedence.adoc[]
-* xref:element-attributes.adoc[]
-** xref:positional-and-named-attributes.adoc[]
-** xref:ids.adoc[]
-** xref:options.adoc[]
-** xref:roles.adoc[]

modules/attributes/nav-element.adoc

+* xref:element-attributes.adoc[]
+** xref:positional-and-named-attributes.adoc[]
+** xref:ids.adoc[]
+** xref:options.adoc[]
+** xref:roles.adoc[]

modules/blocks/nav-breaks.adoc

+* xref:breaks.adoc[]

modules/blocks/nav-paragraph.adoc

@@ -2,4 +2,3 @@
 ** xref:hard-line-breaks.adoc[]
 ** xref:preamble-and-lead.adoc[]
 ** xref:paragraph-alignment.adoc[]
-* xref:breaks.adoc[]

modules/blocks/nav-styles.adoc

+[]
 * xref:admonitions.adoc[]
+
+[]
 * xref:sidebars.adoc[]
+
+[]
 * xref:example-blocks.adoc[]
+
+[]
 * xref:blockquotes.adoc[]
+
+[]
 * xref:verses.adoc[]

modules/directives/nav.adoc

@@ -6,6 +6,8 @@
 ** xref:include-tagged-regions.adoc[]
 ** xref:include-lines.adoc[]
 ** xref:include-uri.adoc[]
+
+[]
 * xref:conditionals.adoc[]
 ** xref:ifdef-ifndef.adoc[]
 ** xref:ifeval.adoc[]

modules/document/nav.adoc

@@ -14,4 +14,6 @@
 *** xref:reference-revision-attributes.adoc[]
 ** xref:metadata.adoc[]
 ** xref:header-ref.adoc[]
+
+[]
 * xref:doctypes.adoc[]

modules/lists/nav.adoc

@@ -3,5 +3,7 @@
 ** xref:ordered.adoc[]
 ** xref:checklist.adoc[]
 ** xref:continuation.adoc[]
+
+[]
 * xref:description.adoc[]
 ** xref:qanda.adoc[]

modules/macros/nav.adoc

@@ -6,11 +6,17 @@
 ** xref:link-macro-attribute-parsing.adoc[]
 ** xref:complex-urls.adoc[]
 ** xref:link-macro-ref.adoc[]
+
+[]
 * xref:xref.adoc[]
 ** xref:inter-document-xref.adoc[]
 ** xref:xref-text-and-style.adoc[]
 ** xref:xref-validate.adoc[]
+
+[]
 * xref:footnote.adoc[]
+
+[]
 * xref:images.adoc[]
 ** xref:images-directory.adoc[]
 ** xref:image-url.adoc[]
@@ -18,10 +24,12 @@
 ** xref:image-size.adoc[]
 ** xref:image-svg.adoc[]
 ** xref:image-ref.adoc[]
+
+[]
 * xref:audio-and-video.adoc[]
-* xref:icons.adoc[]
-** xref:icons-image.adoc[]
-** xref:icons-font.adoc[]
-** xref:icon-macro.adoc[]
+
+[]
 * xref:keyboard-macro.adoc[]
+
+[]
 * xref:ui-macros.adoc[]

modules/sections/nav.adoc

-.Sections
-* xref:titles-and-levels.adoc[]
-** xref:title-links.adoc[]
-** xref:discrete-titles.adoc[]
-* xref:ids.adoc[]
-** xref:id-prefix-and-separator.adoc[]
-* xref:custom-ids.adoc[]
-* xref:numbers.adoc[]
-* xref:styles.adoc[]
-** xref:special-section-titles.adoc[]
-** xref:special-section-numbers.adoc[]
+* Sections
+** xref:titles-and-levels.adoc[]
+*** xref:title-links.adoc[]
+*** xref:discrete-titles.adoc[]
+** xref:ids.adoc[]
+*** xref:id-prefix-and-separator.adoc[]
+** xref:custom-ids.adoc[]
+** xref:numbers.adoc[]
+** xref:styles.adoc[]
+*** xref:special-section-titles.adoc[]
+*** xref:special-section-numbers.adoc[]
 // Front matter
-** xref:colophon.adoc[]
-** xref:dedication.adoc[]
+*** xref:colophon.adoc[]
+*** xref:dedication.adoc[]
 // & Epigraph
-** xref:abstract.adoc[]
-** xref:preface.adoc[]
-** xref:parts.adoc[]
-*** xref:part-numbers-and-labels.adoc[]
-** xref:chapters.adoc[]
+*** xref:abstract.adoc[]
+*** xref:preface.adoc[]
+*** xref:parts.adoc[]
+**** xref:part-numbers-and-labels.adoc[]
+*** xref:chapters.adoc[]
 // Back matter
-** xref:appendix.adoc[]
-** xref:glossary.adoc[]
-** xref:bibliography.adoc[]
-** xref:index.adoc[]
-* xref:section-ref.adoc[]
+*** xref:appendix.adoc[]
+*** xref:glossary.adoc[]
+*** xref:bibliography.adoc[]
+*** xref:index.adoc[]
+** xref:section-ref.adoc[]

modules/verbatim/nav.adoc

-.Verbatim and Source Blocks
-* xref:source-blocks.adoc[]
-** xref:source-highlighter.adoc[]
-** xref:highlight-lines.adoc[]
-** xref:highlight-php.adoc[]
-* xref:listing-blocks.adoc[]
-* xref:literal-blocks.adoc[]
-* xref:callouts.adoc[]
+* Verbatim and Source Blocks
+** xref:source-blocks.adoc[]
+*** xref:source-highlighter.adoc[]
+*** xref:highlight-lines.adoc[]
+*** xref:highlight-php.adoc[]
+** xref:listing-blocks.adoc[]
+** xref:literal-blocks.adoc[]
+** xref:callouts.adoc[]