automation - 1/1 Blog notebook (8) sphinx (13)
automation - 1/1¶
Major changes¶
2016-09-03
I now use YAML to define a build script.
See .local.jenkins.win.yml.
I did not expect that to be so long but it did not scale anymore.
So the process is basically to run a script which interprets the
file .local.jenkins.win.yml
as a series of Jenkins jobs.
Unfortunately, I discovered many issues for some modules
refusing to work from a virtual environment on Windows.
It starts by running function
setup_jenkins_server_yml
.
The rest is pressing buttons.
Convert a notebook into slides¶
2015-05-16
I thought it would be easy to convert a notebook into slides. I would just have to execute nbconvert. I went through two issues. The first one came from reveal.js. My first tries did not work. I decided to take the version included in the module sphinxjp.themes.revealjs and I also updated the output of nbconvert to remove external links as much as possible.
…
Add a custom menu to the notebook¶
2015-05-14
The function add_notebook_menu
add HTML and Javascript to the notebook to create links to all sections in
the notebook:
...
Create a script to read this blog¶
2015-05-10
The module now includes a function
write_module_scripts
creates a script auto_rss_server.py which grabs the latest blog post
from this stream, runs a server and opens the default browser to read them.
It uses the module
pyrsslocal.
Here is the code to read this blog:
...
Frequent commands and automation¶
2015-05-06
The script setup.py
accepts several options
such as install
or build
. It also accepts
unittest
to run the unit tests or build_sphinx
to build the documentation.
It usually requires to have a command line windows opened
as well as an editor to write programs.
On Windows, the module now produces a series of scripts
to automate tasks such as running the unit tests,
building the documentation. They are not included in the sources
anymore but the can be obtained by typing:
...
automation - 1/1 2020-08 (2) 2020-09 (1) 2021-01 (1) 2022-03 (1) 2023-05 (1)