[ 
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 <kant2...@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)

Reply via email to