An example blog

...powered by Newcomen

About This Example

This is an example Newcomen project. You may use it as a starting point to create your own blog or website. This example project also contains some useful information regarding the structure of an Newcomen project and the article source files.

Read more…

posted on 2014 / 02 / 01

Article Sources

This is a regular blog post. The article source format is pretty simple, for example:

title : An Example

---

This is the content…

Read more…

posted on 2014 / 02 / 01

More On Article Sources, And Relative Paths

The source file of this article is a .txt file. It will be included in the blog like the .mmd files, and uses the exact same format. However, the MultiMarkdown formatter will not be applied to this article’s content.

Which formatters are applied depends on the configuration. In the example configuration, the MultiMarkdown formatter will be applied to .mmd files only. On the other hand, the RelativePaths formatter will be applied to all articles:

This is the path of the “Static Page” (as linked in the menu on the left), relative to the current page:

static-page.html

This relative path will change depending on the page this article is included on. For example, it will be different on yearly and monthly index pages.

Read more…

posted on 2014 / 02 / 01

Path Of The Source Files

In this example project the article sources are located in the articles folder (this can be changed in the configuration). The name of the source files has to end in either .mmd or .txt (see this post for an explanation).

The file’s basename (without the extension) will be used as the article’s slug, which will then be used to create the URL of its single article page. The file name may start with one or more digits (09) followed by a dash, this prefix will not be included in the slug, but may be used to sort the files on the filesystem.

Read more…

posted on 2014 / 02 / 01

Article Excerpts

For this article (and most of the other examples), only an excerpt will be shown on index pages and in the Atom feeds.

Read more…

posted on 2014 / 02 / 01