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
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
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
For example if
postsPerPage is 10 and there are 18 posts in our
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.