Take the 2-minute tour ×
Super User is a question and answer site for computer enthusiasts and power users. It's 100% free, no registration required.

I want to put some of my own technical writing on the web: tutorials, how-to's, conceptual articles about programming etc. I write mostly for myself yet, but think others can benefit from it so I want to put it online, and I also have plans of making everything more coherent and turning it into a book.

My articles are not meant as a blog, they're just meant as a collection of tutorials and how-to's, but I think a blog-type software would probably be the most appropriate mode of formatting that kind of stuff.

Right now I am using the blog feature of cite u like, which is very low tech and I really need something better. On my wish list is, among other things:

  • code snippets in scrollable boxes
  • syntax highlighting for source code snippets
  • tagging articles with graphical icons according to topic, like in slashdot
  • of course users (i.e. readers) should be able to comment on articles
  • Also, just more options than a super-simple blog
  • should look slick! should not look wikipedia-like

Is there any software you can recommend for this purpose?

share|improve this question
    
Will you host it yourself? –  Daniel Andersson Apr 4 '12 at 12:34
    
@Daniel Andersson: Yes. I do not want a "software as a service" or anything where I don't have total control over. Would be best if it's open source. –  gojira Apr 4 '12 at 16:24

3 Answers 3

It's not the most mainstream choice, but I really like ikiwiki (by Joey Hess of Debian fame). It's a system written in Perl that compiles by default Markdown pages to static HTML files. Its "blog" templates works for what you want to do.

First and foremost, this system is very flexible and able to do whatever one wants by its very design. With basic Perl, one can also make custom plugins with ease and time.

The entire system is built on version control systems, e.g. Git. The site is rebuilt (well, relevant parts anyway) when content is committed, which gives version control as a built-in feature.

It gives you a comment system using OpenID for identification. You can easily inline code with source highlighting by (preferably) the Perl library for highlight. Code is put in scrollable boxes, and can also be folded (I use that function).

In its default configuration, it looks quite non-pleasing in my opinion, but every aspect is stylable with a local CSS file.

I am very happy with it myself, at least. That it is closely tied to Git/Mercurial/whatever is a killer feature for me, and since every aspect of the site itself can be changed by templates it is more or less infinitely flexible.

share|improve this answer

You can consider Octopress, which has syntax highlighting and code blocks out of the box with Markdown. It has tagging and comments via Disqus with a little bit of configuration.

This would fall under super simple blog - if you want more features, wordpress is an option.

share|improve this answer

For online technical documentation, how about something like http://sphinx.pocoo.org/ for example?

share|improve this answer

Your Answer

 
discard

By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.