Skip to content

Commit cd39655

Browse files
authored
added note to include 1 file in parent folder so that contents inside subfolder show up in wiki.
1 parent f836f8e commit cd39655

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

docs/project/wiki/wiki-file-structure.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -48,6 +48,20 @@ The file name for each wiki page corresponds to the wiki page title. In the file
4848

4949
The _.order_ file defines the wiki page sequence. Git looks for this file in each folder to identify the sequence to present files at that location. The default page sequence is alphabetical order (A to Z) by file name.
5050

51+
> [!IMPORTANT]
52+
> If a parent folder contains only subfolders and no files of its own, the wiki will display the parent folder as blank—even if the subfolders contain markdown files. To ensure that markdown files within subfolders are visible, always include at least one file (such as a .order file or any other file with content) in the parent folder.
53+
54+
```
55+
|- parent-folder
56+
|-- sub-folder1
57+
| |-- file1.md
58+
| |-- file2.md
59+
|-- sub-folder2
60+
| |-- file3.md
61+
| |-- file4.md
62+
|-- .order
63+
```
64+
5165
### Define custom page sequence
5266

5367
When a folder doesn't have an _.order_ file, Git uses the default alphabetical sequence.

0 commit comments

Comments
 (0)