Support empty first item, to create section contents?

[pawamoy]

Without literate-nav, I do this in nav:

    - Layouts:
      - manual/commands/api/layouts/index.md
      - Bsp: manual/commands/api/layouts/bsp.md
      - Columns: manual/commands/api/layouts/columns.md

(I use your section-index plugin)

How would I go about doing the same with literate-nav and gen-files?

If I do the following:

    - Layouts: manual/commands/api/layouts/

...and write this SUMMARY.md manually:

* [](index.md)
* [Bsp](bsp.md)
* [Columns](columns.md)

...it works. But I don't think I can programmatically create such a literate nav with gen-files:

nav = mkdocs_gen_files.Nav()

nav[()] = "index.md"  # error
nav[""] = "index.md"  # error

[oprypin]

The solution in mkdocs_literate_nav for this is:

• Omit index.md. Write this SUMMARY.md:

  * [Bsp](bsp.md)
  * [Columns](columns.md)

• Specify implicit_index.

  plugins:
   - literate-nav:
       nav_file: SUMMARY.md
       implicit_index: true

  ---

Bonus style points for actual literate nav:

• plugins:
   - literate-nav:
       nav_file: index.md
       implicit_index: true

• Write this index.md manually:

  
  # Layout objects
  
  Layouts position windows according to x x x
  
  These are the available layout objects:
  
  <!--nav-->
  * [Bsp](bsp.md)
  * [Columns](columns.md)

[oprypin]

To support this workaround in mkdocs-gen-files, this would be the code change: https://github.com/oprypin/mkdocs-gen-files/commit/d6f08a1c34d429f5703f340b3b7eb14960434312

[pawamoy]

implicit_index: true

Awesome, I missed this option in the docs, sorry!

This option solves my use-case, so the change in mkdocs-gen-files is not critical (but could allow per-summary configuration instead of only global configuration :+1:).

Thanks @oprypin.