Software Recommendations Stack Exchange is a question and answer site for people seeking specific software recommendations. It only takes a minute to sign up.
Sign up to join this community
I'm searching for a blog platform or web framework to set up a blog/archive of personal code snippets (so it should have syntax highlight) and programming articles I might use in the future (a quicksearch would also be nice).
I don't terribly like WordPress and an alternative would be great. As a sidenote: a good-looking one would be preferable.
After reviewing some different alternatives for myself regarding blogging/writing articles on either programming or life in general, I came across stackedit.io, which is an editor within the browser. This could be a good option for you as well.
Some quotes from the Welcome document:
StackEdit stores your documents in your browser, which means all your documents are automatically saved locally and are accessible offline!
...
StackEdit can be combined with Google Drive and Dropbox to have your documents centralized in the Cloud. The synchronization mechanism will take care of uploading your modifications or downloading the latest version of your documents.
...
Once you are happy with your document, you can publish it on different websites directly from StackEdit. As for now, StackEdit can publish on Blogger, Dropbox, Gist, GitHub, Google Drive,Tumblr, WordPress and on any SSH server.
...
StackEdit supports Markdown Extra, which extends Markdown syntax with some nice features. ... GitHub’s fenced code blocks are also supported with Prettify syntax highlighting
In other words you write your stuff in Markdown, with code syntax highlighted with Prettify (or highlight.js). Save it in the cloud, and publish when you are ready for it. If using Gist/GitHub, you'll also also get the search functions you are looking for. Did I mention it is gratis?
I think a blog is not the right kind of information architecture for your purpose: it focuses on the publication date and orders content reverse chronologically (not useful for you), typically comes with features you don’t need (like a comment function), and for organizing your content, you only have tags and sometimes categories.
A wiki should be more suitable: you can organize your content in any way that suits your needs, and creating/editing/linking your content is usually more convenient than in other CMS like blogs.
I’m using WikkaWiki for a similar purpose (and can recommend it as personal wiki).
DokuWiki is another good solution, with the benefit that it doesn’t need a database: all pages are saved in text files.
Both come with syntax highlighting (using GeSHi) by default:
In WikkaWiki, the syntax for code blocks is %% … %%, and for enabling syntax highlighting, it’s %%(javascript) … %%.
In DokuWiki, you can indent code blocks with two spaces (or use <code>…</code> or <file>…</file>). For syntax highlighting, you have to use <code javascript>…</code> or <file javascript>…</file>.
Both also come with a search function, but if you organize your content by adding links to all relevant pages, you’ll probably rarely have to use it. When using my personal wiki, I can visit most of my 2000+ pages by directly entering the URL, or by entering the URL of a "parent" page (e.g., all JavaScript snippets are automatically listed on the JavaScript page’s backlinks, because I add a link from every JS snippet to this page).
Did you try GitHub Gist?
It's not well suited for articles, but it's awesome for code snippets. It has a really nice UI and what I like about it especially is it's integration with the IDE (I use IntelliJ but it has integration with several others) - with a couple of clicks I can create a code snippet.
For example:
In IntelliJ right-click and select "Create Gist...":
After clicking OK this opens up in my web browser:
You can also opt to not open it in the browser and then it's just automatically saved under your GitHub account.
