jashkenas/docco — Issue #67: Using bold in docco.css results in unaligned sourcecode
Author: elliottcable
Created: 2011-11-12 13:40:05+00:00
State: open

This may not sound like a big deal to some, but to those of us that care about the design of our source code, it’s horrid. A large part of the point of docco and other literate-code documentation generators is to put *the code* in front of your user; and when I put a lot of work into ensuring the code is beautiful for said user, I want to ensure that that work translates into my docco-generated webpages.

Compare the following screenshots; notice the loss of alignment below the `var` keyword in the emboldened version:

> ![Docco output, with bold](http://elliottcable.s3.amazonaws.com/p/docco-bolded.png)

----

> ![Docco output, emboldening disabled](http://elliottcable.s3.amazonaws.com/p/docco-unbolded.png)

This is an issue in all browsers known to me.

My suggestion is to modify the default docco.css design to call attention to code elements *without* applying emboldening.