[jira] [Commented] (CB-6751) Use joDoc-js (nodejs) instead of joDoc ruby

["ASF GitHub Bot (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/CB-6751?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14132808#comment-14132808 ] 

ASF GitHub Bot commented on CB-6751:
------------------------------------

GitHub user kant2002 opened a pull request:

    https://github.com/apache/cordova-docs/pull/236

    CB-6751 Added joDoc dependency

    I try using NodeJS joDoc, but have following findings:
    1. It fail to work on Windows out of the box. Because it does not know how to create nested directory structure. Has to put fix for that. Fix available at https://github.com/kant2002/jodoc-js
    2. All pre- and post-processing logic should be reimplemented in JS.
    3. Should be found alternative for Nocogiri in Node.JS community. Seems that this link http://stackoverflow.com/questions/7977945/html-parser-on-nodejs has good options. 
    From first sight https://github.com/cheeriojs/cheerio looks best choice which allows finish implementation faster.
    jsdom looks good to, but looks like it is pain to setup on Windows. Since I develop on Windows, my preference is not to use it.
    
    Also joDocs looks not maintained anymore, so we probable have to put some effort to keep it running as needed for the Cordova. 
    
    Will push updates about this issue to this branch/pull request, as more progress will be done

You can merge this pull request into a Git repository by running:

    $ git pull https://github.com/kant2002/cordova-docs CB-6751

Alternatively you can review and apply these changes as the patch at:

    https://github.com/apache/cordova-docs/pull/236.patch

To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:

    This closes #236
    
----
commit 809c23b91772523570f6d8f5ca15bb41d6294ea1
Author: Andrey Kurdyumov <ka...@gmail.com>
Date:   2014-09-13T16:05:08Z

    Added joDoc dependency

----


> Use joDoc-js (nodejs) instead of joDoc ruby
> -------------------------------------------
>
>                 Key: CB-6751
>                 URL: https://issues.apache.org/jira/browse/CB-6751
>             Project: Apache Cordova
>          Issue Type: Improvement
>          Components: Docs
>    Affects Versions: Master
>            Reporter: Shazron Abdullah
>
> https://github.com/azakus/jodoc-js
> https://github.com/davebalmer/joDoc/issues/17
> This will remove the Ruby dependency and use nodejs which all of us have installed (and all users if they use the CLI)



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)