| Name | sphinx-lesson JSON |
| Version |
0.8.19
JSON |
| download |
| home_page | None |
| Summary | Sphinx extension for CodeRefinery lessons |
| upload_time | 2024-10-23 12:26:28 |
| maintainer | None |
| docs_url | None |
| author | Richard Darst |
| requires_python | >=3.3 |
| license | None |
| keywords |
sphinx-extension
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
Sphinx test lesson
==================
This is a Sphinx extension for software-carpentry style
lessons. It is designed as a replacement for the Jekyll-based software
templates.
* `View the documentation (and example) on github pages
<https://coderefinery.github.io/sphinx-lesson/>`__.
* `Template repository, to copy from
<https://github.com/coderefinery/sphinx-lesson-template/>`__.
Features
--------
- Sphinx, including power from all of its extensions.
- ReST
- Markdown via the `myst_parser` parser, so has access to all Sphinx
directives natively
- Jupyter as a source format, including executing the notebook (via
``myst_nb``).
- Automatically building via Github Actions and automatic deployment
to Github Pages. Included workflow file builds all branches, so you
can also preview pull requests.
- Directives for exercises/prereq/etc, works in both ReST and md.
- The Sphinx part can be separated into a separately installable
and versionable Python package, so we don't need git sub-modules.
- Execute code cells in markdown (via ``myst_nb``).
- Consists of sub-extensions for substitutions. Adding
``sphinx_lesson`` as an extension will bring in these:
- ``sphinx_lesson.directives`` (the core directives)
- ``sphinx_lesson.md_transforms`` (reprocess some other markdown
format into myst_nb format)
- ``myst_nb`` (not developed by us)
Host Site Locally for Development
---------------------------------
1. Create a virtual python environment::
python -m venv venv
2. Activate the virtual environment::
source activate venv/bin/activate
3. Install python packages::
pip install -r requirements.txt
4. Build local files (this can also be used for deployment)::
make html
# Output in _build/html/
make clean html # clean + full rebuild
5. Or, start a live-compiled service for your compiled site for local development::
make livehtml
Then view created site in your browser at `http://localhost:8000 <http://localhost:8000>`__ (follow the link in your console).
Status
------
In beta use by CodeRefinery and active development. External users
would be fine (but let us know so we know to keep things stable).
Raw data
{
"_id": null,
"home_page": null,
"name": "sphinx-lesson",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.3",
"maintainer_email": null,
"keywords": "sphinx-extension",
"author": "Richard Darst",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/69/07/4a4c66a0f1ec2eb285ed0557d8a7a20c79cc70f88468781fcbd52a65fae4/sphinx_lesson-0.8.19.tar.gz",
"platform": null,
"description": "Sphinx test lesson\n==================\n\nThis is a Sphinx extension for software-carpentry style\nlessons. It is designed as a replacement for the Jekyll-based software\ntemplates.\n\n* `View the documentation (and example) on github pages\n <https://coderefinery.github.io/sphinx-lesson/>`__.\n* `Template repository, to copy from\n <https://github.com/coderefinery/sphinx-lesson-template/>`__.\n\n\nFeatures\n--------\n\n- Sphinx, including power from all of its extensions.\n- ReST\n- Markdown via the `myst_parser` parser, so has access to all Sphinx\n directives natively\n- Jupyter as a source format, including executing the notebook (via\n ``myst_nb``).\n- Automatically building via Github Actions and automatic deployment\n to Github Pages. Included workflow file builds all branches, so you\n can also preview pull requests.\n- Directives for exercises/prereq/etc, works in both ReST and md.\n- The Sphinx part can be separated into a separately installable\n and versionable Python package, so we don't need git sub-modules.\n- Execute code cells in markdown (via ``myst_nb``).\n- Consists of sub-extensions for substitutions. Adding\n ``sphinx_lesson`` as an extension will bring in these:\n\n - ``sphinx_lesson.directives`` (the core directives)\n - ``sphinx_lesson.md_transforms`` (reprocess some other markdown\n format into myst_nb format)\n - ``myst_nb`` (not developed by us)\n\n\n\nHost Site Locally for Development\n---------------------------------\n\n1. Create a virtual python environment::\n\n python -m venv venv\n\n2. Activate the virtual environment::\n\n source activate venv/bin/activate\n\n3. Install python packages::\n\n pip install -r requirements.txt\n\n4. Build local files (this can also be used for deployment)::\n\n make html\n # Output in _build/html/\n make clean html # clean + full rebuild\n\n5. Or, start a live-compiled service for your compiled site for local development::\n\n make livehtml\n\n Then view created site in your browser at `http://localhost:8000 <http://localhost:8000>`__ (follow the link in your console).\n\n\n\nStatus\n------\n\nIn beta use by CodeRefinery and active development. External users\nwould be fine (but let us know so we know to keep things stable).\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Sphinx extension for CodeRefinery lessons",
"version": "0.8.19",
"project_urls": {
"Documentation": "https://coderefinery.github.io/sphinx-lesson/",
"Repository": "https://github.com/coderefinery/sphinx-lesson"
},
"split_keywords": [
"sphinx-extension"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "64b93722452e063feb0c3be53d7465a3d1779da8ae34656c9a131b3346018c4a",
"md5": "3f3cd12e29f2aa08678cb30aa23199a4",
"sha256": "9f8fe51a61cbcfc3a9b57916abe15dbd4654cb5f0d9d1e7492a37fec27fe95ff"
},
"downloads": -1,
"filename": "sphinx_lesson-0.8.19-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3f3cd12e29f2aa08678cb30aa23199a4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.3",
"size": 11911,
"upload_time": "2024-10-23T12:26:28",
"upload_time_iso_8601": "2024-10-23T12:26:28.012237Z",
"url": "https://files.pythonhosted.org/packages/64/b9/3722452e063feb0c3be53d7465a3d1779da8ae34656c9a131b3346018c4a/sphinx_lesson-0.8.19-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "69074a4c66a0f1ec2eb285ed0557d8a7a20c79cc70f88468781fcbd52a65fae4",
"md5": "23b7eb07076213bcc84c8986d3d64c42",
"sha256": "acf1a75fa38c21cd6e479465e17766f64beb482e4c3874fe8415c44e36261029"
},
"downloads": -1,
"filename": "sphinx_lesson-0.8.19.tar.gz",
"has_sig": false,
"md5_digest": "23b7eb07076213bcc84c8986d3d64c42",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.3",
"size": 39115,
"upload_time": "2024-10-23T12:26:28",
"upload_time_iso_8601": "2024-10-23T12:26:28.974813Z",
"url": "https://files.pythonhosted.org/packages/69/07/4a4c66a0f1ec2eb285ed0557d8a7a20c79cc70f88468781fcbd52a65fae4/sphinx_lesson-0.8.19.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-23 12:26:28",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "coderefinery",
"github_project": "sphinx-lesson",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "sphinx-lesson"
}
