Getting started with Insiders¤
Markdown PyCon Insiders is a compatible drop-in replacement for Markdown PyCon, and can be installed similarly using pip
or git
. Note that in order to access the Insiders repository, you need to become an eligible sponsor of @pawamoy on GitHub.
Installation¤
with PyPI Insiders¤
PyPI Insiders is a tool that helps you keep up-to-date versions of Insiders projects in the PyPI index of your choice (self-hosted, Google registry, Artifactory, etc.).
See how to install it and how to use it.
We kindly ask that you do not upload the distributions to public registries, as it is against our Terms of use.
with pip (ssh/https)¤
Markdown PyCon Insiders can be installed with pip
using SSH:
pip install git+ssh://git@github.com/pawamoy-insiders/markdown-pycon.git
Or using HTTPS:
pip install git+https://${GH_TOKEN}@github.com/pawamoy-insiders/markdown-pycon.git
How to get a GitHub personal access token
The GH_TOKEN
environment variable is a GitHub token. It can be obtained by creating a personal access token for your GitHub account. It will give you access to the Insiders repository, programmatically, from the command line or GitHub Actions workflows:
- Go to https://github.com/settings/tokens
- Click on Generate a new token
- Enter a name and select the
repo
scope - Generate the token and store it in a safe place
Note that the personal access token must be kept secret at all times, as it allows the owner to access your private repositories.
with Git¤
Of course, you can use Markdown PyCon Insiders directly using Git:
git clone git@github.com:pawamoy-insiders/markdown-pycon
When cloning with Git, the package must be installed:
pip install -e markdown-pycon
Upgrading¤
When upgrading Insiders, you should always check the version of Markdown PyCon which makes up the first part of the version qualifier. For example, a version like 8.x.x.4.x.x
means that Insiders 4.x.x
is currently based on 8.x.x
.
If the major version increased, it's a good idea to consult the changelog and go through the steps to ensure your configuration is up to date and all necessary changes have been made.