rosetree/plasisent.org

Archive :warning: previously: Code and content of my blog; build with ♥ and Nanoc.

⚠️ this is no longer maintained

Archive of plasisent.org

This was the source code of my blog plasisent.org. It used:

• The static site generator Nanoc.
• kramdown to compile markdown.
• SASS as CSS preprocessor.
• HAML to create the layout.

Markdown-Style

• Try to be as compatible as possible.
• Break Markdown at column 80, except when doing an HTML block.

plasisent.org's Issues

Article handling should be easier

It should be a little bit easier to handle the content files. AFAIK there are only two small points, that need to be done, to achieve this goal:

1. Merge meta information files into the content files, so there is only one file per page.
2. Prefer single files over folders. As a small example use content/blogroll.md instead of content/blogroll/index.md when there are no sub-pages.

Remove duplicate content files

Some content files are more than once in this repository. The wrong version should be removed.

• 2015/026
• 2015/029

Add web-feed for all categories and tags

There should be feeds for those who don't want to be notified of every single article (#3). Maybe someone is interested in everything written about surveillance, but doesn't care about anything related to the blog.

This should be generalized, so that I don't have to maintain duplicate code.

Duplicate code: Links to Archives

The commit 59cdd0f added duplicate code to the repository. I’m thinking about creating a layout partial that renders those archive links.

Improve readability on mobile devices

At the moment the readability is okay, I think, as I didn't optimize anything. But I definitely have to improve readability. The homepage looks fine to me, but not the articles detail pages. I guess adding an initial-width could be enough as a first step.
‎
As I'm not a mobile native, any suggestions are welcome.

Make use of HTML5 elements

Nearly a month ago I started to use <aside> in this blog (03bbe54). This is has been a good first step, but I should continue to use more HTML5 elements.

Add web-feed for all articles

It should be possible to be notified of new Articles via feed. I'm not sure whether to use RSS or Atom.

Doubled <figure> on the homepage

This blog filters posts for images and makes their alt attribute available as <figcaption>. On pages, that include compiled posts (e.g. index.html) those generated captions are added twice. This should be prevented.

Migrate to nanoc 4.1

Nanoc 4.1 will be available in the near future. I should migrate this blog to the newest version.

Generate categories from tags

Currently, I have to add a single category to my posts. I think that doesn’t
make any sense. Well it does but I think there is a much more effective way
for categorization.

I assign tags (topics) to every new post. A category could be a collection of
some topics. As an example, a post about GnuPG does belong to Free
Software and Cryptography. This should happen automatically.

Create a cache of previous and next links

Generating those links on compilation is so phenomenal slow, that I don't want to do it that way. I want to create YAML files with list of articles and archives in the correct order, so it's possible to use them.