diff --git a/docs/blog/posts/v0.10.0.md b/docs/blog/posts/v0.10.0.md index 3783b084a637b1b2bbf53c93d3af41bea93c63e3..85ddc554eb0b34d0306f1220656b4cccbf7a0fb8 100644 --- a/docs/blog/posts/v0.10.0.md +++ b/docs/blog/posts/v0.10.0.md @@ -104,7 +104,7 @@ If you missed DeathReaper crowdfunding completion, you can check this [message]( The automated generation of Silkaj Docker images has been implemented in the first place to distribute DeathReaper. This is a new way to install Silkaj and its environment. This is convenient to distribute non-stable releases. -You can find the [documentation on how to use these images](/contributing/container_usage). +You can find the [documentation on how to use these images](../../contributing/container_usage.md). ## Network diff --git a/docs/blog/posts/v0.10.0rc.md b/docs/blog/posts/v0.10.0rc.md index 145eebd94d4473bb27b82195c9f2ab03662eb55c..7fbde6a8c6a03c1eecd5fea2b497b92ea0d0da4a 100644 --- a/docs/blog/posts/v0.10.0rc.md +++ b/docs/blog/posts/v0.10.0rc.md @@ -24,7 +24,7 @@ To install the Python package, run following command: pip3 install silkaj --user --upgrade --pre ``` -To [install and run Silkaj from a container](/contributing/container_usage): +To [install and run Silkaj from a container](../../contributing/container_usage.md): ``` sudo docker pull registry.duniter.org/clients/python/silkaj/release/pip:v0.10.0rc0 diff --git a/docs/blog/posts/v0.11.0.md b/docs/blog/posts/v0.11.0.md index bcb23f30de8b8679b5349531416172802f97cd3e..e4c507ea08923a3a89871d0e2e66bc1bdb5c140e 100644 --- a/docs/blog/posts/v0.11.0.md +++ b/docs/blog/posts/v0.11.0.md @@ -43,7 +43,7 @@ sudo apt install pipx libsodium23 pipx install silkaj ``` -For a comprehensive documentation, check the [installation documentation](/install). +For a comprehensive documentation, check the [installation documentation](../../install.md). ## New CLI design diff --git a/docs/blog/posts/v0.11.0rc0.md b/docs/blog/posts/v0.11.0rc0.md index 05c340ea80d511394c56f6cceee5ade32f8d502e..ed9953594f84418c4a349064497978816b5dd219 100644 --- a/docs/blog/posts/v0.11.0rc0.md +++ b/docs/blog/posts/v0.11.0rc0.md @@ -22,14 +22,14 @@ It is planned to be the latest release with Duniter v1/BMA support and the relea You can install this pre-release version from PyPI or from a Docker image. To install the Python package, run following command: -Install `pipx` from the [installation documentation](/install): +Install `pipx` from the [installation documentation](../../install.md): ``` sudo apt install pipx pipx install --pip-args "\--pre" silkaj ``` -To [install and run Silkaj from the container](/contributing/container_usage): +To [install and run Silkaj from the container](../../contributing/container_usage.md): ``` sudo docker pull registry.duniter.org/clients/python/silkaj/release/pip:v0.11.0rc0 @@ -51,7 +51,7 @@ Make sure you test it on Ğ1-Test network to avoid a revocation or any money los ## Pipx installation -Test that the newly introduced [`pipx` method installation documentation](/install) works fine in your case, with your particular Unix system. +Test that the newly introduced [`pipx` method installation documentation](../../install.md) works fine in your case, with your particular Unix system. Tell us how can the documentation be improved, if a non-obvious step for you is missing or if a necessary package isn't listed for Silkaj to work on your system. ## New CLI design diff --git a/docs/blog/posts/v0.8.md b/docs/blog/posts/v0.8.md index 3b81ed510844bf69a3703eb746103373718814ec..f54167d18557616a37b23f4fc98a212c2df9bdb6 100644 --- a/docs/blog/posts/v0.8.md +++ b/docs/blog/posts/v0.8.md @@ -202,14 +202,14 @@ Within 0-342803 range, blocks with a wrong signature: 15144 31202 85448 87566 90 ### A. Poetry <center> -{: style="height:120px;width:120px"} +{: style="height:120px;width:120px"} </center> We migrated the packaging and the dependency management tool from Pipenv to Poetry since Pipenv has been quite problematic recently and is also more suitable for larger projects. In comparison, [Poetry](https://python-poetry.org/) is a well thought and stable tool which has been released by the end of 2019. In the former development environment, we had to define the dependencies twice in the `requirements.txt`, `setup.{py,cfg}`, `Pipenv` files. Poetry, however, supports the `pyproject.toml` file standardized by the Python project and is able to define the dependencies at once. -If you would like to install Silkaj for development purposes, please follow [this tutorial](/contributing/install_poetry/). You may also interested by checking the newly introduced contribution process documentation `CONTRIBUTING.md`. +If you would like to install Silkaj for development purposes, please follow [this tutorial](../../contributing/install_poetry.md). You may also interested by checking the newly introduced contribution process documentation `CONTRIBUTING.md`. ### B. Automatic container generation @@ -223,7 +223,7 @@ Based on the containers set out above, a continuous integration and delivery pip - Tests on all supported Python versions, - Release publication automation on PyPI and PyPI test. - + ## 7. Tests diff --git a/docs/contributing/index.md b/docs/contributing/index.md index 7982f0c8062ec995d9a017725a600e814d393b7f..0bf5385c7ba5189965dda82824edba5857ab3f1f 100644 --- a/docs/contributing/index.md +++ b/docs/contributing/index.md @@ -6,7 +6,7 @@ Part of the Duniter project running the Ğ1 currency, Silkaj project is aiming a ## Install the development environment -We are using [Poetry](https://python-poetry.org/) as a development environment solution. Start by [installing Poetry](/contributing/install_poetry/). +We are using [Poetry](https://python-poetry.org/) as a development environment solution. Start by [installing Poetry](./install_poetry.md). This will install a sandboxed Python environment. Dependencies will be installed in it in order to have Silkaj running and to have pre-installed developement tools. @@ -127,7 +127,7 @@ Check out [duniterpy#169](https://git.duniter.org/clients/python/duniterpy/-/iss [{: style="height:150px;width:150px"}](https://pytest.org) </center> -We are using [Pytest](https://pytest.org) as a tests framework. For more information on how Silkaj implements them check the [testing documentation](/contributing/testing/). +We are using [Pytest](https://pytest.org) as a tests framework. For more information on how Silkaj implements them check the [testing documentation](./testing.md). Tests are stored into `unit` and `integration` folders depending on their types, then using a similar tree as the source code. diff --git a/docs/index.md b/docs/index.md index 69ae61252e20af2775bbc68a78815f6d0d3fdbb5..a18687f7a482186b70a76d7d95cc976d5a22cbe7 100644 --- a/docs/index.md +++ b/docs/index.md @@ -11,7 +11,7 @@ hide: Welcome to Silkaj documentation -[Install :material-package-down:](/install){ .md-button .md-button--primary } [Usage :material-keyboard-outline:](/usage){ .md-button .md-button--primary } +[Install :material-package-down:](install.md){ .md-button .md-button--primary } [Usage :material-keyboard-outline:](usage/index.md){ .md-button .md-button--primary } ## What is Silkaj? diff --git a/docs/install.md b/docs/install.md index a6691dec83d6e2f59895ce56d931eb29e69d9439..dc4e123f1c27a0f716811ac487d609aa3db8baa1 100644 --- a/docs/install.md +++ b/docs/install.md @@ -166,4 +166,4 @@ For further details checkout [Click documentation](https://click.palletsprojects ## Install to contribute -Check out the [installation guide with Poetry](/contributing/install_poetry/). +Check out the [installation guide with Poetry](./contributing/install_poetry.md). diff --git a/docs/usage/multi-recipients_transfers_and_automation.md b/docs/usage/multi-recipients_transfers_and_automation.md index b4eeaf6d5bf519ea93bd93a20be03408bb734d18..f00a0d70baf1b3b699729ec43abc178d296bb357 100644 --- a/docs/usage/multi-recipients_transfers_and_automation.md +++ b/docs/usage/multi-recipients_transfers_and_automation.md @@ -20,7 +20,7 @@ The file content should be prefixed with `RELATIVE` or `ABSOLUTE` so the amounts ### Set up the authentication -- Check [authentication documentation](/account_storage#Authentication) on how to handle the authentication. +- Check [authentication documentation](./account_storage.md#authentication) on how to handle the authentication. ### Transfer