Devdocs for Padrino
63 views
Skip to first unread message
wikimatze de
Mar 11, 2016, 12:50:36 AM3/11/16
to devdocs
I had an issue with getting content of docs for Padrino (http://www.rubydoc.info/github/padrino/padrino-framework/) as described here https://github.com/Thibaut/devdocs/issues/345.
I've implemented the
I get the following error when running thor docs:generate padrino:
thor docs:generate padrino Note: this command will scrape the documentation from the source. Some scrapers require a local setup. Others will send thousands of HTTP requests, potentially slowing down the source site. Please don't use it unless you are modifying the code. To download the latest tested version of a documentation, use: thor docs:download padrino Proceed? (y/n) y [###################################################################################################################################################] [1/1] [100.00%] [00:00] [00:00] [3.03/s]URL: http://www.rubydoc.info/github/padrino/padrino-framework /home/wm/.rvm/gems/ruby-2.3.0/gems/nokogiri-1.6.7.2/lib/nokogiri/xml/node.rb:819:in `coerce': Requires a Node, NodeSet or String argument, and cannot accept a NilClass. (ArgumentError) (You probably want to select a node from the Document with at() or search(), or create a new Node via Node.new().) from /home/wm/.rvm/gems/ruby-2.3.0/gems/nokogiri-1.6.7.2/lib/nokogiri/xml/node.rb:769:in `add_sibling' from /home/wm/.rvm/gems/ruby-2.3.0/gems/nokogiri-1.6.7.2/lib/nokogiri/xml/node.rb:184:in `add_previous_sibling' from /home/wm/.rvm/gems/ruby-2.3.0/gems/nokogiri-1.6.7.2/lib/nokogiri/xml/node.rb:208:in `before' from /home/wm/git/devdocs/lib/docs/filters/padrino/clean_html.rb:7:in `call'
Cheers,
Matthias
I've implemented the
get_name / get_type / additional_entries in my entries-filter and pushed the filters. You can find my code under https://github.com/wikimatze/devdocs/tree/padrino-supportI get the following error when running thor docs:generate padrino:
thor docs:generate padrino Note: this command will scrape the documentation from the source. Some scrapers require a local setup. Others will send thousands of HTTP requests, potentially slowing down the source site. Please don't use it unless you are modifying the code. To download the latest tested version of a documentation, use: thor docs:download padrino Proceed? (y/n) y [###################################################################################################################################################] [1/1] [100.00%] [00:00] [00:00] [3.03/s]URL: http://www.rubydoc.info/github/padrino/padrino-framework /home/wm/.rvm/gems/ruby-2.3.0/gems/nokogiri-1.6.7.2/lib/nokogiri/xml/node.rb:819:in `coerce': Requires a Node, NodeSet or String argument, and cannot accept a NilClass. (ArgumentError) (You probably want to select a node from the Document with at() or search(), or create a new Node via Node.new().) from /home/wm/.rvm/gems/ruby-2.3.0/gems/nokogiri-1.6.7.2/lib/nokogiri/xml/node.rb:769:in `add_sibling' from /home/wm/.rvm/gems/ruby-2.3.0/gems/nokogiri-1.6.7.2/lib/nokogiri/xml/node.rb:184:in `add_previous_sibling' from /home/wm/.rvm/gems/ruby-2.3.0/gems/nokogiri-1.6.7.2/lib/nokogiri/xml/node.rb:208:in `before' from /home/wm/git/devdocs/lib/docs/filters/padrino/clean_html.rb:7:in `call'
Cheers,
Matthias
Thibaut Courouble
Mar 13, 2016, 9:50:58 PM3/13/16
to devdocs
Hey
It's likely because "title" on L5 is nil:
https://github.com/wikimatze/devdocs/blob/padrino-support/lib/docs/filters/padrino/clean_html.rb#L5
It's likely because "title" on L5 is nil:
https://github.com/wikimatze/devdocs/blob/padrino-support/lib/docs/filters/padrino/clean_html.rb#L5
wikimatze de
Mar 23, 2016, 3:02:26 PM3/23/16
to devdocs
Hi Thibaut,
it's working right now. One issue I have is how to highlight code properly. Since it's ruby how can I make code examples look like angualr for example. All code examples are rendered as tables with the current implementation https://github.com/wikimatze/devdocs/tree/padrino-support.
Thanks for this great tool and the support.
it's working right now. One issue I have is how to highlight code properly. Since it's ruby how can I make code examples look like angualr for example. All code examples are rendered as tables with the current implementation https://github.com/wikimatze/devdocs/tree/padrino-support.
Thanks for this great tool and the support.
Thibaut Courouble
Mar 26, 2016, 11:04:38 AM3/26/16
to devdocs
Hey
Don't worry about styling & code highlighting. I can take care of that myself.
The important thing is for the index (entries & types) to be clean & well organized.
Thibaut
Don't worry about styling & code highlighting. I can take care of that myself.
The important thing is for the index (entries & types) to be clean & well organized.
Thibaut
wikimatze de
May 16, 2016, 12:43:20 AM5/16/16
to devdocs
Hi Thibaut,
I checked the scraper for Padrino again and everything is in there what should be there. The only problem is, that links to classes/methods/files are only working if I append .html to them. Looking forward to the integration. Should I make the Pull-Request?
I checked the scraper for Padrino again and everything is in there what should be there. The only problem is, that links to classes/methods/files are only working if I append .html to them. Looking forward to the integration. Should I make the Pull-Request?
Thibaut Courouble
May 28, 2016, 11:21:27 AM5/28/16
to devdocs
Hey
Sorry for the late reply. Not sure what's up with the links. If all entries are scraped and indexed properly (sidebar is grouped by class, entries have unique names, etc.) then yes feel free to open a PR.
Thibaut
Sorry for the late reply. Not sure what's up with the links. If all entries are scraped and indexed properly (sidebar is grouped by class, entries have unique names, etc.) then yes feel free to open a PR.
Thibaut
wikimatze de
Jun 2, 2016, 11:40:30 AM6/2/16
to devdocs
That's fine, I'll make the pull request for it then.
Reply all
Reply to author
Forward
0 new messages