httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Daniel Gruno <rum...@cord.dk>
Subject Re: Syntax Highlighting
Date Fri, 20 Apr 2012 12:54:20 GMT
On 20-04-2012 14:49, Igor Galić wrote:
> 
> Hey folks,
> 
> for all those who haven't seen them yet, Daniel has started
> working on developer documentation:
> 
>   http://httpd.apache.org/docs/trunk/developer/modguide.html
> 
> this also contains syntax highlighting.
> I'm a sucker for syntax highlighting, mostly because I couldn't
> survive without.
> 
> If you've looked at the source code however...
> 
>   https://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/manual/developer/modguide.xml
> 
> you'll notice that the current solution is sub-optimal.
> There are a lot of syntax-highlighters. enscript being the
> first to come to my mind.
> 
> Does someone who know our docs-build system well enough
> to modify it so to automagickally highlight <example>
> sections? If not, maybe we could organize a session (on
> IRC) to do some reverse-engineering.
> 
> In any case, we should document the process or the outcome,
> so those coming after us won't be put before the exact same
> problems.
> 
> So long,
> 
> i
> 
Yes, +1 (heck, +2) to this. Manually highlighting the examples is a pain
in the behind, especially when you make a mistake and you have to do it
all over again because you can't spot where to insert your corrected
lines due to all the <code> clutter.

I've tried looking at the XSLT stuff we use, but I just wound up being
even more confused. If there's anyone out there who can help, please,
please speak up :)

With regards,
Daniel.

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Mime
View raw message