Deploy na Cloudflare Pages¶

Ten projekt jest przygotowany pod MkDocs i Cloudflare Pages.

Co jest już gotowe w repo¶

• mkdocs.yml w katalogu głównym,
• źródła dokumentacji w docs/,
• requirements.txt z mkdocs,
• .python-version do przypięcia wersji Pythona,
• .gitignore z ignorowaniem katalogu site/.

Ustawienia w Cloudflare Pages¶

W projekcie Pages ustaw:

• Production branch: main
• Build command: mkdocs build
• Build output directory: site
• Root directory: /

Python¶

Cloudflare Pages obsługuje przypinanie wersji Pythona przez PYTHON_VERSION albo plik .python-version.

W tym repo użyty jest plik:

• .python-version = 3.13.3

To jest lepsze niż stare przykłady z Pythonem 3.7, bo aktualny build image Pages wspiera nowsze wersje Pythona.

Jak podpiąć repo¶

1. Wejdź do Cloudflare Dashboard.
2. Otwórz Workers & Pages.
3. Wybierz Create application.
4. Przejdź do zakładki Pages.
5. Wybierz Import an existing Git repository.
6. Wskaż repo piotrbudner/martyna-sales-system.
7. Ustaw parametry buildu zgodnie z sekcją wyżej.
8. Uruchom pierwszy deploy.

Po pierwszym deployu¶

Cloudflare nada adres w stylu:

• https://<project>.pages.dev

Jeśli później podepniesz własną domenę albo końcowy adres pages.dev, warto uzupełnić w mkdocs.yml pole:

site_url: https://twoj-adres/

Lokalne sprawdzenie przed deployem¶

python -m pip install -r requirements.txt
mkdocs build

Jeśli build przejdzie lokalnie, Pages powinno zbudować projekt tak samo.