pyscript/docs/development/setting-up-environment.md

Setting up your development environment

• Fork the repository - quicklink

• Clone your fork of the project

git clone https://github.com/<your username>/pyscript

• Add the original project as your upstream (this will allow you to pull the latest changes)

git remote add upstream git@github.com:pyscript/pyscript.git

• cd into the pyscriptjs folder using the line below in your terminal (if your terminal is already in pyscript then use cd pyscriptjs instead)

cd pyscript/pyscriptjs

• Install the dependencies with the command below (you must have node >=16)

make setup

       NOTE: If make setup gives a node/npm version required error then go to troubleshooting

• You can also run the examples locally by running the command below in your terminal

make examples

• Run npm run dev to build and run the dev server. This will also watch for changes and rebuild when a file is saved.

npm run dev

       NOTE: To access your local build paste http://localhost:8080 into your browser

Now that node and npm have both been updated make setup should work, and you can continue setting up your local environment without problems (hopefully).

Setting up and building the docs

To build the documentation locally first make sure you are in the docs directory.

You'll need make and conda installed in your machine. The rest of the environment should be automatically download and created for you once you use the command:

make setup

Use conda activate $environment_name to activate your environment.

To add new information to the documentation make sure you conform with PyScript's code of conduct and with the general principles of Diataxis. Don't worry about reading too much on it, just do your best to keep your contributions on the correct axis.

Write your documentation files using Markedly Structured Text, which is very similar to vanilla Markdown but with some addons to create the documentation infrastructure.

Once done, initialize a server to check your work:

make livehtml

Visible here: http://127.0.0.1:8000