Single vs List

Or what to name your content files: foo.md vs index.md vs _index.md.

On this page:

Top level page (example.com/lorem/)

graph TD A("example.com/lorem/") --> C C{"Does this page
have child pages
(ie /lorem/ipsum/)?
"} C --- D[Yes] C --- E[No] E --> F F{"Does this page
have Page Resources
(ie lorem/photo.jpg)?"} F ---G F ---H G["No"] --> indexmd G["No"] --> ipsummd H["Yes"] --> indexmd indexmd("content/lorem/index.md") ipsummd("content/lorem.md") ipsummd -.- slayout indexmd -.- slayout slayout["Default layout file used"] slayout --> single("single.html") D --> lindex("content/lorem/_index.md") lindex -.- llayout["Default layout file used"] llayout --> list("list.html") click indexmd "/circle/" "Example" click ipsummd "/square/" "Example" click lindex "/clouds/" "Example" style lindex stroke-width:4px, stroke:#91C7B1; style indexmd stroke-width:4px, stroke:#91C7B1; style ipsummd stroke-width:4px, stroke:#91C7B1; style A stroke-width:4px, stroke:#6153CC; style single stroke-width:4px, stroke:#336699; style list stroke-width:4px, stroke:#336699;

Page nested one level (example.com/lorem/ipsum/)

This assumes that content/lorem/ is a list page.

graph TD A("example.com/lorem/ipsum/") --> C C{"Does this page
have child pages
(ie /lorem/ipsum/dolor/)?
"} C --- D[Yes] C --- E[No] E --> F F{"Does this page have
Page Resources
(ie ipsum/photo.jpg)?"} F ---G F ---H G["No"] --> indexmd G["No"] --> ipsummd H["Yes"] --> indexmd indexmd("content/lorem/ipsum/index.md") ipsummd("content/lorem/ipsum.md") ipsummd -.- slayout indexmd -.- slayout slayout["Default layout file used"] slayout --> single("single.html") D --> lindex("content/lorem/ipsum/_index.md") lindex -.- llayout["Default layout file used"] llayout --> list("list.html") click indexmd "/colors/yellow/" "Example" click ipsummd "/colors/green/" "Example" click lindex "/colors/" "Example" style A stroke-width:4px, stroke:#6153CC; style indexmd stroke-width:4px, stroke:#91C7B1; style ipsummd stroke-width:4px, stroke:#91C7B1; style lindex stroke-width:4px, stroke:#91C7B1; style single stroke-width:4px, stroke:#336699; style list stroke-width:4px, stroke:#336699;

Some Page Vars

DOT (.) Page(/single-vs-list.md)
.File single-vs-list.md
.Kind page
.Type page
.Section
.Sections
.Parent Page(/_index.md)
.IsPage true
.IsNode false
.Pages
.Resources false

Content Structure

Homepage _index.md
  1. Circle circle/index.md
  2. Clouds clouds/_index.md
    1. Cirrus clouds/cirrus.md
    2. Nimbus clouds/nimbus.md
  3. Colors colors/_index.md
    1. Blue Title colors/blue/index.md
    2. Green Title colors/green.md
    3. Orange Title colors/orange/index.md
    4. Red Title colors/red.md
    5. Yellow Title colors/yellow/index.md
  4. Crescent crescent/index.md
  5. Ellipse ellipse/index.md
  6. Fruit fruit/_index.md
    1. Banana fruit/banana.md
    2. Berries fruit/berries/_index.md
      1. Blackberries fruit/berries/blackberries/index.md
      2. Blueberries fruit/berries/blueberries/index.md
      3. Raspberries fruit/berries/raspberries.md
      4. Strawberries fruit/berries/strawberries/index.md
    3. Citrus fruit/citrus/_index.md
      1. Lemons fruit/citrus/lemons.md
      2. Limes fruit/citrus/limes.md
      3. Oranges fruit/citrus/oranges.md
    4. Stonefruit fruit/stonefruit/_index.md
      1. Apricots fruit/stonefruit/apricots.md
      2. Nectarines fruit/stonefruit/nectarines.md
      3. Plums fruit/stonefruit/plums.md
  7. Layout Lookup Order layout-lookup.md
  8. Letters letters/_index.md
    1. A letters/a.md
    2. B letters/b.md
  9. Metals metals/_index.md
    1. Gold metals/gold.md
    2. Silver metals/silver.md
  10. Oval oval/index.md
  11. Page Resources page-resources.md
  12. Rectangle rectangle.md
  13. Rhombus rhombus.md
  14. Single vs List single-vs-list.md
  15. Square square.md
  16. Trapezoid trapezoid.md
  17. Trees trees/_index.md
    1. Acacia trees/acacia.md
    2. Fig trees/fig.md
    3. Mahogany trees/mahogany.md
    4. Pine trees/pine.md

Sibling Sections (.Parent.Sections)

PageTitleFile
Page(/clouds/_index.md) Clouds clouds/_index.md
Page(/colors/_index.md) Colors colors/_index.md
Page(/fruit/_index.md) Fruit fruit/_index.md
Page(/letters/_index.md) Letters letters/_index.md
Page(/metals/_index.md) Metals metals/_index.md
Page(/trees/_index.md) Trees trees/_index.md

No Children Sections (.Sections)

No Children Pages (.Pages)

No Page Resources