Welcome to the PyScript documentation repository.
Contribute prose and participate in discussions about the written support of PyScript and related topics.
Before you start contributing to the documentation, it's worthwhile to take a look at the general contributing guidelines for the PyScript project. You can find these guidelines here Contributing Guidelines
The docs
directory in the pyscript repository contains a
Material for MkDocs documentation project. Material is a system
that takes plaintext files containing documentation written in Markdown, along with
static files like templates and themes, to build the static end result.
To setup the documentation development environment simply create a new
virtual environment, then pip install -r requirements.txt
(from in the root
of this repository).
Simply run mkdocs serve
You can link to other pages in the documentation by using the {doc}
role. For example, to link to the docs/README.md
file, you would use:
{doc}`docs/README.md`
You can also cross-reference the python glossary by using the {term}
role. For example, to link to the iterable
term, you would use:
{term}`iterable`
You can also cross-reference functions, methods or data attributes by using the {attr}
for example:
{py:func}`repr`
This would link to the repr
function in the python builtins.