• entries
    615
  • comments
    4,398
  • views
    663,336

Help System Revision

Sign in to follow this  
Followers 0
Josh

30 views

I'm not entirely happy with the output of HelpNDoc for a few reasons. It outputs a great variety of formats, but doesn't do a spectacular job of any. I hoped to use CHM for local help but these do not scale well on high-resolution displays, and the technology will not be updated by Microsoft. HelpNDoc's HTML output is okay but not great, so I started experimenting with my own HTML to get exactly the look and functionality I want.

 

RIght now I have a javascript-based treeview for navigation, breadcrumb links, syntax highlighting for Lua and C++, responsive design, the ability to switch between C++ and Lua documentation on the same page, and the code examples select the entire block when you click on them. There's still more work to do, but so far this is the most promising method that is giving the best results. I am not sure yet if this will be a lot of PHP files or a utility program that spits out a bunch of HTML files.

 

blogentry-1-0-82981500-1489471156_thumb.jpg

 

blogentry-1-0-57106600-1489471168_thumb.jpg

 

I'm going to focus on the format of the data and then I'll post a job on Upwork and find someone else to do the grunt work of filling in all the content.


8
  Report Entry
Sign in to follow this  
Followers 0


3 Comments


@Josh have you considered hiring from the community instead of places like Upwork?

0

Share this comment


Link to comment

@Josh have you considered hiring from the community instead of places like Upwork?

I don't do this because it causes people to leave. I've even been on the other side of this, and I did the same thing. I don't know the exact reason why, but it is predictable. Anyone is welcome to find the job on Upwork if they wish to.
0

Share this comment


Link to comment

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!


Create Your Account

Sign in

Already have an account? Sign in here.


Sign In Now