https://github.com/practicalli/cycling
Practical guide to cycing, route planning, training and essential maintenance
https://github.com/practicalli/cycling
Last synced: 4 months ago
JSON representation
Practical guide to cycing, route planning, training and essential maintenance
- Host: GitHub
- URL: https://github.com/practicalli/cycling
- Owner: practicalli
- Created: 2026-01-05T22:11:09.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-02-27T17:05:05.000Z (4 months ago)
- Last Synced: 2026-02-27T19:43:57.799Z (4 months ago)
- Language: Makefile
- Homepage: https://practical.li/cycling/
- Size: 141 KB
- Stars: 1
- Watchers: 0
- Forks: 1
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Practicalli Cycling
```none
██████╗ ██████╗ █████╗ ██████╗████████╗██╗ ██████╗ █████╗ ██╗ ██╗ ██╗
██╔══██╗██╔══██╗██╔══██╗██╔════╝╚══██╔══╝██║██╔════╝██╔══██╗██║ ██║ ██║
██████╔╝██████╔╝███████║██║ ██║ ██║██║ ███████║██║ ██║ ██║
██╔═══╝ ██╔══██╗██╔══██║██║ ██║ ██║██║ ██╔══██║██║ ██║ ██║
██║ ██║ ██║██║ ██║╚██████╗ ██║ ██║╚██████╗██║ ██║███████╗███████╗██║
╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═╝╚══════╝╚══════╝╚═╝
```
## Book status
[](https://github.com/practicalli/cycling/actions/workflows/megalinter.yaml)
[](https://github.com/practicalli/cycling/actions/workflows/publish-book.yaml)
[](https://github.com/practicalli/cycling/actions/workflows/pages/pages-build-deployment)
## Creative commons license
This work is licensed under a Creative Commons Attribution 4.0 ShareAlike License (including images & stylesheets).
# Overview
Practical guides to cycling route planning, training and essential maintenance.
## Contributing
Issues and pull requests are most welcome although it is the maintainers discression as to if they are applicable. Please detail issues as much as you can. Pull requests are simpler to work with when they are specific to a page or at most a section. The smaller the change the quicker it is to review and merge.
Please read the [detailed Practicalli contributing page](https://practical.li/contributing/) before raising an issue or pull request to avoid disappointment.
* [Current Issues](https://github.com/practicalli/cycling/issues)
* [Current pull requests](https://github.com/practicalli/cycling/pulls)
By submitting content ideas and corrections you are agreeing they can be used in this workshop under the [Creative Commons Attribution ShareAlike 4.0 International license](https://creativecommons.org/licenses/by-sa/4.0/). Attribution will be detailed via [GitHub contributors](https://github.com/practicalli/cycling/graphs/contributors).
## Sponsor Practicalli
[](https://github.com/sponsors/practicalli-johnny/)
All sponsorship funds are used to support the continued development of [Practicalli series of books and videos](https://practical.li/), although most work is done at personal cost and time.
Thanks to [Cognitect](https://www.cognitect.com/), [Nubank](https://nubank.com.br/) and a wide range of other [sponsors](https://github.com/sponsors/practicalli-johnny#sponsors) for your continued support
## Star History
[](https://star-history.com/#practicalli/cycling&Date)
## GitHub Actions
The megalinter GitHub actions will run when a pull request is created,checking basic markdown syntax.
A review of the change will be carried out by the Practicalli team and the PR merged if the change is acceptable.
The Publish Book GitHub action will run when PR's are merged into main (or the Practicalli team pushes changes to the default branch).
Publish book workflow installs Material for MkDocs version 9
## Local development
Zensical can be installed locally via vu or pip. Practicalli uses uv for simplicity. Commands are wrapped in tasks defined within the `Makefile`.
Clone the repository and change into the root of the project.
```shell
git clone https://github.com/practicalli/cycling
```
Install Zensical as a tool using `uv` (updating if there is a new version).
```shell
make docs-install
```
Build the website and serve locally at [http://localhost:8000](http://localhost:8000)
```shell
make docs
```
---
Specific command if now using make:
Create a virtual python in the root of the project.
```shell
uv tool install zensical --upgrade
```