Sections

As discussed in the Content Organisation section, how you organise your content in your file system is mirrored in the final built site. With this in mind, Aoife uses the top level folders within the /content folder as the section.

The following example site has a static home page and two sections post and review:

content
  - index.md              // http://example.com/
  - post
  --- First Post.md       // http://example.com/post/first-post.html
  --- Second Post.md      // http://example.com/post/second-post.html
  - review
  --- Die Hard.md         // http://example.com/review/die-hard.html
  --- Star Trek.md        // http://example.com/star-trek.html

Section lists

If a file titled index.md is located within a top-level (section) folder then Aoife will render that at /section/index.html. If no index.md file is present then Aoife will automatically generate an index page listing all content within that section. It will automatically paginate the index if there are more posts than specified in the postsPerPage variable in the site’s config.json file. For example if postsPerPage is 10 and there are 18 posts in our review section, Aoife will create a site structure as below:

http://example.com/review         // listing of first 10 reviews
http://example.com/review/page/2  // listing of reviews 11-18

For more information on how to style these automatically generated lists from a theme, including how to access information on the individual posts in the list, see the List Content section.

Modified: Dec 6, 2016 at 21:26:14

Aoife v0.9.0 documentation