Exclude Files from rendering when they are not in .pages file and no "..." is given about mkdocs-awesome-pages-plugin HOT 7 CLOSED

Unfortunately that's not possible in the current version. I like the idea though. In hindsight I would probably design it this way. But now that this would be a breaking change I have to consider whether to include it in the next major version or hide it behind an option...

from mkdocs-awesome-pages-plugin.

An option would make sense, from my point of view. With that, a breaking change would be avoided. :)

from mkdocs-awesome-pages-plugin.

@lukasgeiter what about extending the hide setting that allows for targeted hiding of pages while keeping the default behavior of hiding the directory. The following suggestions allows for maintaining compatibility with the current interface while allowing for targeted hiding of specific or un-arranged pages. This could then be further expanded by adding a ... line item to the hide setting to change the default unspecified page behavior from "show after arranged pages" to "hide all un-arranged pages".

File structure for these suggestions are as follows:

• foo
  • .pages
  • bar.md
  • index.md
  • not-included.md

Current behavior

Show un-arranged pages

index.md is shown before automated arrangement of non-included.md and bar.md.

title: Test
arrange:
    - index.md

Hide a directory

Entire foo directory is hidden from nav menu.

title: Test
arrange:
    - index.md
hide: true

Enhancement Suggestions

Hide a single page

index.md and bar.md are included, but not-included.md is hidden from the nav menu.

title: Test
arrange:
    - index.md
hide:
    - not-included.md

Hide all un-arranged pages

index.md are included, but not-included.md and 'bar.md` are hidden from the nav menu.

title: Test
arrange:
    - index.md
hide:
    - ...

from mkdocs-awesome-pages-plugin.

If reusing the hide setting is not desirable, a new one could be created. Maybe named exclude.

from mkdocs-awesome-pages-plugin.

@lukasgeiter any updates on this?

from mkdocs-awesome-pages-plugin.

@alexander-matthiesen Sorry for the long wait. I've recently started working on this and some other features. A new release should be ready soon. I'll keep you posted.

from mkdocs-awesome-pages-plugin.

Hi everyone! I've just released v2.3.0 which brings the nav attribute to the .pages file. nav supports a few new tricks, but more importantly for this issue, it does not automatically add files that are not mentioned unless you explicitly specify a ... entry. See the updated README for details.

^{Mentioning people who upvoted, so they get a notification as well: @steph-ben, @fenik17}

@kleinen I went with this approach instead of extending hide since I believe an explicit ... entry makes things more predictable and it aligns the behavior with mkdocs' own nav config. If anyone still has a need for a separate option to hide certain pages, please let me know (ideally by creating a new issue with your use case).

from mkdocs-awesome-pages-plugin.