Skip to content
This repository was archived by the owner on Feb 14, 2024. It is now read-only.

Commit d42e96b

Browse files
martinRenoumartinRenou
committed
Add docs
1 parent 9763d58 commit d42e96b

File tree

7 files changed

+531
-3
lines changed

7 files changed

+531
-3
lines changed

‎.readthedocs.yaml

+9
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
version: 2
2+
3+
build:
4+
os: "ubuntu-20.04"
5+
tools:
6+
python: "mambaforge-4.10"
7+
8+
conda:
9+
environment: docs/environment.yml

‎README.md

+8-3
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,11 @@
11
# jupyterlite-xeus-python-kernel
22

3-
[![Github Actions Status](https://github.com/jupyterlite/xeus-python-kernel/workflows/Build/badge.svg)](https://github.com/jupyterlite/xeus-python-kernel/actions/workflows/build.yml)
3+
[![ci-badge]][ci] [![docs-badge]][docs]
4+
5+
[ci-badge]: https://github.com/jupyterlite/xeus-python-kernel/workflows/Build/badge.svg
6+
[ci]: https://github.com/jupyterlite/xeus-python-kernel/actions?query=branch%3Amain
7+
[docs-badge]: https://readthedocs.org/projects/xeus-python-kernel/badge/?version=latest
8+
[docs]: https://xeus-python-kernel.readthedocs.io/en/latest/?badge=latest
49

510
The [xeus-python](https://github.com/jupyter-xeus/xeus-python) Python kernel for JupyterLite running in the browser.
611

@@ -15,7 +20,7 @@ The [xeus-python](https://github.com/jupyter-xeus/xeus-python) Python kernel for
1520
To install the extension, execute:
1621

1722
```bash
18-
pip install jupyterlite_xeus_python
23+
pip install jupyterlite-xeus-python
1924
```
2025

2126
Then build your JupyterLite site:
@@ -29,7 +34,7 @@ jupyter lite build
2934
To remove the extension, execute:
3035

3136
```bash
32-
pip uninstall jupyterlite_xeus_python
37+
pip uninstall jupyterlite-xeus-python
3338
```
3439

3540
## Contributing

‎docs/Makefile

+194
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,194 @@
1+
# Makefile for Sphinx documentation
2+
#
3+
4+
# You can set these variables from the command line.
5+
SPHINXOPTS =
6+
SPHINXBUILD = sphinx-build
7+
PAPER =
8+
BUILDDIR = build
9+
10+
# User-friendly check for sphinx-build
11+
ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
12+
$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
13+
endif
14+
15+
# Internal variables.
16+
PAPEROPT_a4 = -D latex_paper_size=a4
17+
PAPEROPT_letter = -D latex_paper_size=letter
18+
ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
19+
# the i18n builder cannot share the environment and doctrees with the others
20+
I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
21+
22+
.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest coverage gettext api
23+
24+
default: html
25+
26+
help:
27+
@echo "Please use \`make <target>' where <target> is one of"
28+
@echo " html to make standalone HTML files"
29+
@echo " dirhtml to make HTML files named index.html in directories"
30+
@echo " singlehtml to make a single large HTML file"
31+
@echo " pickle to make pickle files"
32+
@echo " json to make JSON files"
33+
@echo " htmlhelp to make HTML files and a HTML help project"
34+
@echo " qthelp to make HTML files and a qthelp project"
35+
@echo " applehelp to make an Apple Help Book"
36+
@echo " devhelp to make HTML files and a Devhelp project"
37+
@echo " epub to make an epub"
38+
@echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
39+
@echo " latexpdf to make LaTeX files and run them through pdflatex"
40+
@echo " latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
41+
@echo " text to make text files"
42+
@echo " man to make manual pages"
43+
@echo " texinfo to make Texinfo files"
44+
@echo " info to make Texinfo files and run them through makeinfo"
45+
@echo " gettext to make PO message catalogs"
46+
@echo " changes to make an overview of all changed/added/deprecated items"
47+
@echo " xml to make Docutils-native XML files"
48+
@echo " pseudoxml to make pseudoxml-XML files for display purposes"
49+
@echo " linkcheck to check all external links for integrity"
50+
@echo " doctest to run all doctests embedded in the documentation (if enabled)"
51+
@echo " coverage to run coverage check of the documentation (if enabled)"
52+
53+
clean:
54+
rm -rf $(BUILDDIR)/*
55+
56+
html:
57+
$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
58+
@echo
59+
@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
60+
61+
dirhtml:
62+
$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
63+
@echo
64+
@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
65+
66+
singlehtml:
67+
$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
68+
@echo
69+
@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
70+
71+
pickle:
72+
$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
73+
@echo
74+
@echo "Build finished; now you can process the pickle files."
75+
76+
json:
77+
$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
78+
@echo
79+
@echo "Build finished; now you can process the JSON files."
80+
81+
htmlhelp:
82+
$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
83+
@echo
84+
@echo "Build finished; now you can run HTML Help Workshop with the" \
85+
".hhp project file in $(BUILDDIR)/htmlhelp."
86+
87+
qthelp:
88+
$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
89+
@echo
90+
@echo "Build finished; now you can run "qcollectiongenerator" with the" \
91+
".qhcp project file in $(BUILDDIR)/qthelp, like this:"
92+
@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/bqplot.qhcp"
93+
@echo "To view the help file:"
94+
@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/bqplot.qhc"
95+
96+
applehelp:
97+
$(SPHINXBUILD) -b applehelp $(ALLSPHINXOPTS) $(BUILDDIR)/applehelp
98+
@echo
99+
@echo "Build finished. The help book is in $(BUILDDIR)/applehelp."
100+
@echo "N.B. You won't be able to view it unless you put it in" \
101+
"~/Library/Documentation/Help or install it in your application" \
102+
"bundle."
103+
104+
devhelp:
105+
$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
106+
@echo
107+
@echo "Build finished."
108+
@echo "To view the help file:"
109+
@echo "# mkdir -p $$HOME/.local/share/devhelp/bqplot"
110+
@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/bqplot"
111+
@echo "# devhelp"
112+
113+
epub:
114+
$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
115+
@echo
116+
@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
117+
118+
latex:
119+
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
120+
@echo
121+
@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
122+
@echo "Run \`make' in that directory to run these through (pdf)latex" \
123+
"(use \`make latexpdf' here to do that automatically)."
124+
125+
latexpdf:
126+
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
127+
@echo "Running LaTeX files through pdflatex..."
128+
$(MAKE) -C $(BUILDDIR)/latex all-pdf
129+
@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
130+
131+
latexpdfja:
132+
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
133+
@echo "Running LaTeX files through platex and dvipdfmx..."
134+
$(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
135+
@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
136+
137+
text:
138+
$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
139+
@echo
140+
@echo "Build finished. The text files are in $(BUILDDIR)/text."
141+
142+
man:
143+
$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
144+
@echo
145+
@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
146+
147+
texinfo:
148+
$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
149+
@echo
150+
@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
151+
@echo "Run \`make' in that directory to run these through makeinfo" \
152+
"(use \`make info' here to do that automatically)."
153+
154+
info:
155+
$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
156+
@echo "Running Texinfo files through makeinfo..."
157+
make -C $(BUILDDIR)/texinfo info
158+
@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
159+
160+
gettext:
161+
$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
162+
@echo
163+
@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
164+
165+
changes:
166+
$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
167+
@echo
168+
@echo "The overview file is in $(BUILDDIR)/changes."
169+
170+
linkcheck:
171+
$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
172+
@echo
173+
@echo "Link check complete; look for any errors in the above output " \
174+
"or in $(BUILDDIR)/linkcheck/output.txt."
175+
176+
doctest:
177+
$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
178+
@echo "Testing of doctests in the sources finished, look at the " \
179+
"results in $(BUILDDIR)/doctest/output.txt."
180+
181+
coverage:
182+
$(SPHINXBUILD) -b coverage $(ALLSPHINXOPTS) $(BUILDDIR)/coverage
183+
@echo "Testing of coverage in the sources finished, look at the " \
184+
"results in $(BUILDDIR)/coverage/python.txt."
185+
186+
xml:
187+
$(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
188+
@echo
189+
@echo "Build finished. The XML files are in $(BUILDDIR)/xml."
190+
191+
pseudoxml:
192+
$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
193+
@echo
194+
@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."

‎docs/environment.yml

+14
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
name: xeus-python-kernel-docs
2+
3+
channels:
4+
- conda-forge
5+
6+
dependencies:
7+
- yarn
8+
- jupyterlab
9+
- jupyter-packaging
10+
- pydata-sphinx-theme
11+
12+
- pip:
13+
- jupyterlite-xeus-python
14+
- jupyterlite-sphinx

0 commit comments

Comments
 (0)