Rubin Observatory's framework for Sphinx-based technote documents.
Project description
Technote
Rubin Observatory's framework for Sphinx-based technote documents. Learn more at https://technote.lsst.io.
Install from PyPI:
pip install technote
technote is developed by Rubin Observatory at https://github.com/lsst-sqre/technote.
Features
Warning Technote is in initial design and development. The features described below may not be implemented yet.
Technotes are web-native, single page websites that facilitate rapid scientific and technical communication. The "technote" package provides the framework for creating technotes:
- A Sphinx theme optimized for single page documents, like technotes. This theme can be customized by organizations.
- A
technote.tomlmakes it easy to configure document metadata. - Technotes can be written in reStructuredText, Markdown, or as Jupyter notebooks.
Developing technote
The best way to start contributing to technote is by cloning this repository, creating a virtual environment, and running the make init command:
git clone https://github.com/lsst-sqre/technote.git
cd technote
make init
You can run tests and build documentation with tox:
tox
To learn more about the individual environments:
tox -av
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file technote-0.1.0.tar.gz.
File metadata
- Download URL: technote-0.1.0.tar.gz
- Upload date:
- Size: 14.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.9.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c14f6a188e1c345af56517b59133bb6199c1009e599e01cb054e9bfda40dfd71 |
|
| MD5 | dac51c07296787fd10af50babe8ec2ad |
|
| BLAKE2b-256 | a81c8a238de2e08f9958438542530c0d088028a7c0824bc14e6b86278b75da0e |
File details
Details for the file technote-0.1.0-py3-none-any.whl.
File metadata
- Download URL: technote-0.1.0-py3-none-any.whl
- Upload date:
- Size: 4.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.9.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 3e6afba03ed43abbdcfe75fc4f96c0ad3a01cc7c35ba9a8511644f6f511f135c |
|
| MD5 | 97b854e3c2dae01aa74098af02512c0b |
|
| BLAKE2b-256 | a37cae07d2bbf028f60a4a552a5ea1a06fbd3f6e281eddc81d366ffc41710e43 |
