Available for your viewing pleasure at docs.phonegap.com.
This repository is currently undergoing a major update. At the moment, it is not published live to docs.phonegap.com. In the future it will be!
npm install
npm start
This will start a local server in development mode. The server will generate
all of the documentation to /out
and watch for file changes. When a file is
changed, BrowserSync will regenerate the file and refresh your browser.
\
phonegap-docs/
|
|__ assets/ # Assets that need to be rendered
| |
| |__ styles/ # Stylus files rendered to /out/styles/**/*.css
|
|__ docs/ # Markdown documents rendered to /out/**/*.html
|
|__ layouts/ # Layouts and view templates
|
|__ out/ # Outputted static website
|
|__ public/ # Static assets copied to /out/**/*
|
|__ docpad.json # Configuration
You may see an error such as :
error: Something went wrong while rendering: /Users/mwbrooks/Development/lib/phonegap-docs/docs/tutorials/optimize/index.html.jade
The error follows:
TypeError: /Users/mwbrooks/Development/lib/phonegap-docs/layouts/tutorialspage.html.jade:21
19| .prev
20| -if(document.next)
> 21| - var next = getCollection("html").findOne({url:document.next}).toJSON();
22| a.page__navigation--next(href=next.url)!= "Next: " next.title
23| -else
24| .prev
Cannot read property 'toJSON' of null
This is because you are linking directly to the HTML document instead of it's
clean URL directory path. Our generator uses the Clean URL plugin, which
transforms each file.html
into file/index.html
. The original file.html
continues to exist but will redirect to file/index.html
.
When referencing a file, you should reference path/to/file
instead of
path/to/file.html
. Referencing the HTML document will generate the error above.