8000 DOC: Doc build for a single doc made much faster, and clean up by datapythonista · Pull Request #24428 · pandas-dev/pandas · GitHub
[go: up one dir, main page]
Skip to content

DOC: Doc build for a single doc made much faster, and clean up #24428

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 13 commits into from
Dec 30, 2018
Merged

DOC: Doc build for a single doc made much faster, and clean up #24428

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
2571572
WIP: Major refactoring and clean up, still some problems on building …
datapythonista Dec 14, 2018
83c3b45
building only api pages when needed, based on SPHINX_PATTERN, and not…
datapythonista Dec 14, 2018
a5e7ad2
Merge from master
datapythonista Dec 23, 2018
0fda07e
Merge remote-tracking branch 'upstream/master' into single_doc
datapythonista Dec 24, 2018
e851cae
WIP simplifying doc build (pending not generate rst files from exclud…
datapythonista Dec 25, 2018
fc9c359
Not generating all the api pages or the intersphinx db when a single …
datapythonista Dec 25, 2018
8e1e9e4
Merge remote-tracking branch 'upstream/master' into single_doc
datapythonista Dec 25, 2018
ade46e6
Restoring python path env
datapythonista Dec 25, 2018
648da45
Fixing comment with wrong info
datapythonista Dec 26, 2018
c489aa6
Removing not needed raw_input
datapythonista Dec 26, 2018
2be1d61
Merging from master
datapythonista Dec 28, 2018
55e47a2
Adding value to --single error message
datapythonista Dec 29, 2018
4406988
Changing num_jobs default value to 0 everywhere, to be consistent
datapythonista Dec 29, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Not generating all the api pages or the intersphinx db when a single … 
…page is built
  • Loading branch information
@datapythonista
datapythonista committed Dec 25, 2018
commit fc9c359c86d449b5967070ff7fd9de0df5ef1a53
1 change: 1 addition & 0 deletions doc/make.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,7 @@ def __init__(self, num_jobs=1, include_api=True, single_doc=None,
elif not include_api:
os.environ['SPHINX_PATTERN'] = '-api'

self.single_doc_html = None
if single_doc and single_doc.endswith('.rst'):
self.single_doc_html = os.path.splitext(single_doc)[0] + '.html'
elif single_doc:
Expand Down
23 changes: 11 additions & 12 deletions doc/source/conf.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,6 @@
# (e.g. '10min.rst' or 'generated/pandas.DataFrame.head.rst')
source_path = os.path.dirname(os.path.abspath(__file__))
pattern = os.environ.get('SPHINX_PATTERN')
autosummary_generate = pattern != '-api'
if pattern:
for dirname, dirs, fnames in os.walk(source_path):
for fname in fnames:
Expand All @@ -117,6 +116,7 @@
single_doc=(pattern
if pattern is not None and pattern != '-api'
else None)))
autosummary_generate = True if pattern is None else ['index']

# matplotlib plot directive
plot_include_source = True
Expand Down Expand Up @@ -396,17 +396,16 @@
# latex_use_modindex = True


intersphinx_mapping = {
'statsmodels': ('http://www.statsmodels.org/devel/', None),
'matplotlib': ('https://matplotlib.org/', None),
'pandas-gbq': ('https://pandas-gbq.readthedocs.io/en/latest/', None),
'python': ('https://docs.python.org/3/', None),
'numpy': ('https://docs.scipy.org/doc/numpy/', None),
'scipy': ('https://docs.scipy.org/doc/scipy/reference/', None),
'py': ('https://pylib.readthedocs.io/en/latest/', None)
}
import glob
autosummary_generate = glob.glob("*.rst")
if pattern is None:
intersphinx_mapping = {
'statsmodels': ('http://www.statsmodels.org/devel/', None),
'matplotlib': ('https://matplotlib.org/', None),
'pandas-gbq': ('https://pandas-gbq.readthedocs.io/en/latest/', None),
'python': ('https://docs.python.org/3/', None),
'numpy': ('https://docs.scipy.org/doc/numpy/', None),
'scipy': ('https://docs.scipy.org/doc/scipy/reference/', None),
'py': ('https://pylib.readthedocs.io/en/latest/', None)
}

# extlinks alias
extlinks = {'issue': ('https://github.com/pandas-dev/pandas/issues/%s',
Expand Down
0