OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Task list of WebHelp for GSoC 2012

Hi all,

The mentors for webhelp has come up with the following priority feature list to be expected from the possible students for webhelp [1]. If you are eligible to participate, and like to contribute to DocBook, and WebHelp, then join with us. The list provided might look overwhelming at first. For a new user, it always will be. :-) But by the time, it'll be OK. Unless otherwise specified, almost all the tasks expected are moderate. I would classify only one to have a bit of more research involved. The possible students can of course discuss about these and come to an agreement on what needs to be implemented which will match with our objectives, and students current skills plus skills that s/he like to develop.

During the proposal period, only keep your focus on first 5 tasks here and (6) a. Please don't hesitate to ask questions you may have regarding the provided tasks, and DocBook in general. There's still time to discuss and submit a proposal. The proposal deadline is April 6th, 19:00 UTC.

[1] http://docbook.xmlpress.net/tiki-index.php?page=Ideas2012#Webhelp

  1. Provide an example Makefile as an alternative to the ant script
  1. Removal of the dependency on Ant. Make WebHelp build with make, so that people using make and xsltproc can build WebHelp. 
  1. This would be a good starter task for the student to get a feel for how thing work. 
  1. There might be a sample Makefile to get the implementor of this going, or to give the student some ideas.
  1. Parameterize list of files to exclude from indexing. Currently it's hard coded that we don't index index.html and ix01.html (the legal notice and index topics). It should be smarter and automatically not index the index file even if it's not named ix01.html. Add to the indexer the ability to specify a list of files or file patterns not to index. Currently it does not index index.html or ix01.html, which is generally appropriate, but it should be up to the user to decide.
  1. Search functionality improvements
  1. Add other search options:
  1. Add an option to create webhelp as a webapp using Lucene as the search engine.
  1. Strip quotes from search queries (if a user searches for "foo bar" with quotes, strip the quotes). Currently a quoted search shows no results.
  1. That would be a relatively easy and quick fix, and would add a lot of benefit.
  1. Improve image copying functionality to deal with xincluded content. - This could be blocker for some projects, and it doesn't WYSIWYG IDE friendly. Current image copying feature is very primitive.
  1. Enhanced configurability, together with improved readability of the code (webhelp.xsl). These issues are somewhat interwoven; being able to  make WebHelp more configurable is hard when the code is hard to parse. 
  1. EASY Tasks
  1. Remove the "content" folder in WebHelp output (and thus in the  template). - Easy
  1. This is fairly easy work. Further, this could be a sub-task under (parameterize list of files to exclude from indexing.) 
  1. This could be implemented after (2).
  1. Make it possible to include the document title in the html page's <head><title> without also having the document title appear in the search results summary.
  1. Adding this task here is arguable. Would this be configurable? If not, would everyone regard this an improvement?
  1. Make sure we give an informative message if they come to the page using NoScript or with cookies disabled.
  1. NoScript is all over the place these days, so the informative message could even be "please configure NoScript to allow _javascript_ for this page".

Low Priority
  1. Add autocompletion to the search box (This was suggested by one of the students and is an interesting idea).
  1. This could of lower priority. Shall we keep this to the end? `
  1. If someone dies to implement this, why not, but otherwise it's a "nice to have" item to the largest possible extent. :-)
  1. Make the toc width adjustable (is this even possible?)
  1. It's possible, generally. But should look whether this can be integrated into webhelp design. low prioriy!
  1. Fix some bugs:
  1. Sidebar does not remain collapsed when clicking next/previous
  1. Improve performance in IE 8/9 (remove need for "treat as IE 7 directive")
  1. Adjust titlepage templates so abstract is not shown by default.

Kasun Gajasinghe
Software Engineer; WSO2 Inc.; http://wso2.com,
linked-in: http://lk.linkedin.com/in/gajasinghe
blog: http://blog.kasunbg.org


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]