Skip to main content

No project description provided

Project description


✨ Luma: Next-gen Python documentation✨

PyPI version versions Documentation Discord


image

Luma is better way to write Python documentation. It's a modern replacement for Sphinx that's built on the same tooling Stripe uses for their documentation.

Key benefits of Luma:

  • Markdown-native: Avoid Sphinx’s obscure syntax.
  • Built for Python: API generation and cross-referencing work out-of-the-box.
  • Live rendering: Preview your changes as you write.

Getting started

Install Luma

To install Luma, install the package from PyPI:

pip install luma-docs

Create a new Luma project

Once you've installed Luma, run the init command, and answer the prompts:

luma init

After running the command, you'll see a docs/ folder in your current working directory.

Run the development server

cd into the docs/ folder, and run the dev command to start the local development server. Then, open the printed address in your browser. The address is usually http://localhost:3000/.

cd docs
luma dev

Hit Ctrl + C to stop the development server.

Publish your documentation

Join our Discord to acquire an API key. Then, run the deploy command to publish your documentation.

luma deploy

After a minute, your documentation will be accessible at https://{your-package}.luma-docs.org.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

luma_docs-0.0.11.tar.gz (246.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

luma_docs-0.0.11-py3-none-any.whl (263.8 kB view details)

Uploaded Python 3

File details

Details for the file luma_docs-0.0.11.tar.gz.

File metadata

  • Download URL: luma_docs-0.0.11.tar.gz
  • Upload date:
  • Size: 246.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.4 CPython/3.12.4 Darwin/23.6.0

File hashes

Hashes for luma_docs-0.0.11.tar.gz
Algorithm Hash digest
SHA256 e0f7630eb5abcb83e06f23811f4a162cbb5498ff04fdb13dbf3e1cb274d8397a
MD5 f72c7dfb32024c9df1bf1776600f75c4
BLAKE2b-256 b36ad18f8f1562bd8f9ef83fa4590dd79883b7fa975501e4a406afd0545cd81c

See more details on using hashes here.

File details

Details for the file luma_docs-0.0.11-py3-none-any.whl.

File metadata

  • Download URL: luma_docs-0.0.11-py3-none-any.whl
  • Upload date:
  • Size: 263.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.4 CPython/3.12.4 Darwin/23.6.0

File hashes

Hashes for luma_docs-0.0.11-py3-none-any.whl
Algorithm Hash digest
SHA256 9ef576ec831d251df4c256cec98e22cee2605f01b1ddfa4e3390324691ebcce9
MD5 b6728908de55bbbe34e05133b382001b
BLAKE2b-256 f1429c166b08d8e1d7f84f3ed75d29a8b9dcc35a35f69b87ed940a26b67a9a9f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page