History

Add documentation on building FileScraper docs

Jed Fox committed 6 years ago

Commit d475f241 parent 58a01203 files · +71 −10Browse files

Unified · Split

3 files
  1. docs/file-scrapers.md +71 −0
  2. lib/docs/scrapers/dart.rb +0 −2
  3. lib/docs/scrapers/salt_stack.rb +0 −8
docs/file-scrapers.md+71−0
@@ -0,0 +1,71 @@
1# File Scraper Reference
2
3This lists the docs that use `FileScraper` and instructions for building some of them.
4
5If you open a PR to update one of these docs, please add/fix the instructions.
6
7## C
8
9Download the HTML book from https://en.cppreference.com/w/Cppreference:Archives
10and copy `reference/en/c` from the ZIP file into `/path/to/devdocs/docs/c`.
11
12## C++
13
14Download the HTML book from https://en.cppreference.com/w/Cppreference:Archives
15and copy `reference/en/cpp` from the ZIP file into `/path/to/devdocs/docs/cpp`.
16
17## Dart
18
19Click the “API docs” link under the “Stable channel” header on
20https://www.dartlang.org/tools/sdk/archive. Rename the expanded ZIP to `dart~2`
21and put it in `/path/to/devdocs/docs/`
22
23## Django
24
25Go to https://docs.djangoproject.com/, select the version from the
26bubble in the bottom-right corner, then download the HTML version from the sidebar.
27
28## Erlang
29
30Go to https://www.erlang.org/downloads and download the HTML documentation file.
31
32## Gnu
33
34### GCC
35### GNU Fortran
36
37## NumPy
38
39## OpenJDK
40
41## Perl
42
43## PHP
44
45## Python
46
47## RDoc
48
49### Nokogiri
50### Ruby / Minitest
51### Ruby on Rails
52### Ruby
53
54## Salt Stack
55
56Replace `2019.2` with the correct tag.
57
58```sh
59git clone https://github.com/saltstack/salt.git --branch 2019.2 --depth 1
60cd salt/doc
61pip install sphinx
62make html
63```
64
65The generated html is in `salt/doc/_build/html`. Copy it to
66
67## Scala
68
69See `lib/docs/scrapers/scala.rb`
70
71## SQLite
lib/docs/scrapers/dart.rb+0−2
@@ -20,8 +20,6 @@ module Docs · 19 unmodified lines
20 Licensed under the Creative Commons Attribution-ShareAlike License v4.0.20 Licensed under the Creative Commons Attribution-ShareAlike License v4.0.
21 HTML21 HTML
22 22
23 # Download the documentation from https://www.dartlang.org/tools/sdk/archive
24
25 version '2' do23 version '2' do
26 self.release = '2.5.0'24 self.release = '2.5.0'
27 self.base_url = "https://api.dart.dev/stable/#{release}/"25 self.base_url = "https://api.dart.dev/stable/#{release}/"
lib/docs/scrapers/salt_stack.rb+0−8
@@ -1,13 +1,5 @@
1module Docs1module Docs
2 # The official documentation website is heavily rate-limited2 # The official documentation website is heavily rate-limited
3 #
4 # The documentation can be generated like this (replace 2019.2 with the correct tag):
5 # $ git clone https://github.com/saltstack/salt.git --branch 2019.2 --depth 1
6 # $ cd salt/doc
7 # $ pip install sphinx
8 # $ make html
9 #
10 # The generated html can be found in salt/doc/_build/html
11 class SaltStack < FileScraper3 class SaltStack < FileScraper
12 self.type = 'simple'4 self.type = 'simple'
13 self.slug = 'saltstack'5 self.slug = 'saltstack'