Return-Path: X-Original-To: apmail-cordova-dev-archive@www.apache.org Delivered-To: apmail-cordova-dev-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 76EE917F8D for ; Tue, 4 Nov 2014 11:55:32 +0000 (UTC) Received: (qmail 83248 invoked by uid 500); 4 Nov 2014 11:55:31 -0000 Delivered-To: apmail-cordova-dev-archive@cordova.apache.org Received: (qmail 83228 invoked by uid 500); 4 Nov 2014 11:55:31 -0000 Mailing-List: contact dev-help@cordova.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@cordova.apache.org Delivered-To: mailing list dev@cordova.apache.org Received: (qmail 83215 invoked by uid 99); 4 Nov 2014 11:55:30 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 04 Nov 2014 11:55:30 +0000 X-ASF-Spam-Status: No, hits=1.7 required=5.0 tests=FREEMAIL_ENVFROM_END_DIGIT,HTML_MESSAGE,RCVD_IN_DNSWL_LOW,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (nike.apache.org: domain of kant2002@googlemail.com designates 209.85.213.169 as permitted sender) Received: from [209.85.213.169] (HELO mail-ig0-f169.google.com) (209.85.213.169) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 04 Nov 2014 11:55:05 +0000 Received: by mail-ig0-f169.google.com with SMTP id hn18so6264713igb.0 for ; Tue, 04 Nov 2014 03:54:18 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :content-type; bh=ZB69CUH7uEyNHyYyORxdUzPFaNd2MvlYs3fIECTl2Dc=; b=Bv9Or+XgXpINixANAnCnaAkybWJ12tC/EgdouElJ+Ku0Ryv9iNsRzHeAr0lTdptYwe LSBqItlXsCNzkGMmxZsKCJazEsT2DdYX3Tso4gC3bThspOZSXv3D1nS887WhVtVzExzz UNx113Mh86brn1uU53d1kD0F1dJdwu8P3DbbeeNB+Si87q0Gqh5Z7mBX8VDUnYYkiIH7 1fv4uOSyu6yikSKPaWC2i6Wqi8iqogIbK2zZ7PQDxjz2Y6EcdAr+td7iVP3peV4apYsu G3iYvVVDAUjFQfqHaZ/zmcZQw6/mrkB1yKlZAIKL25g69w119cCqn8f/QVk/6kxgVv+g FnEQ== MIME-Version: 1.0 X-Received: by 10.43.76.67 with SMTP id zd3mr2705892icb.42.1415102058853; Tue, 04 Nov 2014 03:54:18 -0800 (PST) Received: by 10.64.62.47 with HTTP; Tue, 4 Nov 2014 03:54:18 -0800 (PST) In-Reply-To: References: Date: Tue, 4 Nov 2014 17:54:18 +0600 Message-ID: Subject: Re: Documentation generation in pure Node.JS From: Andrey Kurdumov To: dev@cordova.apache.org Content-Type: multipart/alternative; boundary=001a11c31e0c8a19b70507071f64 X-Virus-Checked: Checked by ClamAV on apache.org --001a11c31e0c8a19b70507071f64 Content-Type: text/plain; charset=UTF-8 I also find that links in Guides is missing. Not yet sure why is that looking into that. Issue which Shazron discover should be fixed now. 2014-11-04 3:00 GMT+06:00 Michal Mocny : > Just tried it using the steps Shaz listed on the PR and its working for me > fine. However, there are some warnings during generation (bunch of "Did > not found link for the keyword"), and the generated pages appear to have > some links missing (such as the first page, Guides do not link to > anything). Unsure if the warning is the cause of the missing links. > > Keep chugging away! > > -Michal > > On Mon, Nov 3, 2014 at 2:39 PM, Andrew Grieve > wrote: > > > Love that you're working on this! > > > > On Mon, Nov 3, 2014 at 12:57 AM, Shazron wrote: > > > > > Thanks Andrey, > > > I tested it out but I ran into problems. See my comment on your pull > > > request. > > > > > > On Sun, Nov 2, 2014 at 1:11 PM, Andrey Kurdumov < > kant2002@googlemail.com > > > > > > wrote: > > > > > > > Hello guys, > > > > > > > > I almost finish implementing > > > > https://issues.apache.org/jira/browse/CB-6751 > > > > > > > > In short this is implementation of Cordova Docs website generator > using > > > > Node.JS instead of relying on Vagrant and Ruby. > > > > > > > > Summary of work: > > > > - Implementation duplicates Ruby code as much as possible. Tests > which > > > was > > > > written for Ruby, was reimplemented in JS. > > > > - Created new executable genjs in the bin folder, which generate > > > > documentation to the *public/test* folder, instead of *public* > folder, > > so > > > > differences between implementation could be found using standard > > diffing > > > > tools. > > > > - Implementation verified on Mac and Windows. > > > > - Small improvements to CLI interface (single language generation, > > single > > > > version generation, added verbose mode for tracing execution) > > > > - As I can tell, JS implementation produce almost same HTML code as > > Ruby > > > > version. I done some smoke testing of changes and seems that > everything > > > is > > > > good, but willing that you guys look at the docs too. > > > > > > > > To make this works with existing documentation and support Windows, I > > > have > > > > to fork existing implementation of joDoc-js ( > > > > https://github.com/kant2002/jodoc-js) > > > > > > > > Issues: > > > > - Windows suffer from occasional EPERM issues during generation of > the > > > > docs. > > > > > > > > Pull request for that implementation is here: > > > > https://github.com/apache/cordova-docs/pull/236 > > > > > > > > Best regards, > > > > Andrey > > > > > > > > > > --001a11c31e0c8a19b70507071f64--