From d089cd5d75d0b9eedceee0b1ea33ffc408cbb3db Mon Sep 17 00:00:00 2001 From: Simon Forman Date: Fri, 24 Apr 2020 13:27:13 -0700 Subject: [PATCH] Minor edits. --- README | 32 ++++++++++++++++++++++++-------- 1 file changed, 24 insertions(+), 8 deletions(-) diff --git a/README b/README index 519c3ed..156b418 100644 --- a/README +++ b/README @@ -10,21 +10,22 @@ -------------------------------------------------- -Copyright © 2014-2019 Simon Forman +Copyright © 2014-2020 Simon Forman This file is part of Thun Thun is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software -Foundation, either version 3 of the License, or (at your option) any later -version. +Foundation, either version 3 of the License, or (at your option) any +later version. Thun is distributed in the hope that it will be useful, but WITHOUT ANY -WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A -PARTICULAR PURPOSE. See the GNU General Public License for more details. +WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS +FOR A PARTICULAR PURPOSE. See the GNU General Public License for more +details. -You should have received a copy of the GNU General Public License along with -Thun. If not see . +You should have received a copy of the GNU General Public License along +with Thun. If not see . -------------------------------------------------- @@ -57,15 +58,30 @@ Or if you have downloaded the source, from the top directory: python ./setup.py install -Or you can run the package from the top directory. To start a crude REPL: +Or you can run the package directly from the top directory. + +To start a crude REPL: python -m joy §.3 Documentation +§.3.1 Jupyter Notebooks + The docs/ folder contains Jupyter notebooks, ... TODO +§.3.2 Sphinx Docs + +Some of the documentation is in the form of ReST files + +§.3.3 Building the Docs + +Building the documentation is a little tricky at the moment. It involves +a makefile that uses nbconvert to generate ReST files from some of the +notebooks, copies those to the sphinx source dir, then builds the HTML +output using sphinx. + §.4 Basics of Joy