flit
mkdocs-material
Our great sponsors
flit | mkdocs-material | |
---|---|---|
6 | 93 | |
2,094 | 18,269 | |
0.9% | - | |
6.4 | 9.8 | |
about 2 months ago | 4 days ago | |
Python | HTML | |
BSD 3-clause "New" or "Revised" License | MIT License |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
flit
-
Show HN: Code Indexer Loop
Queries on https://github.com/pypa/flit/tree/main/flit_core/flit_core (omitted tests/)
(Pdb) print(indexer.query("def normalize_dist_name(name: str, version: str) -> str:"))
-
Underappreciated Challenges with Python Packaging
If it's pure Python, the only packaging file you need is `pyproject.toml`. You can fill that file with packaging metadata per PEP 518 and PEP 621, including using modern build tooling like flit[1] for the build backend and build[2] for the frontend.
With that, you entire package build (for all distribution types) should be reducible to `python -m build`. Here's an example of a full project doing everything with just `pyproject.toml`[3] (FD: my project).
[1]: https://github.com/pypa/flit
[2]: https://github.com/pypa/build
[3]: https://github.com/pypa/pip-audit
-
Easy Packing and Publishing to PyPi with Flit, pytest, and Circleci
I published a very simple project flit_pytest_circleci_template that uses: * [flit](https://github.com/pypa/flit) to build a package. * pytest to test it * circleci to run the above and publish the package to pypi whenever a source file is committed. This is the hard part IMO as I do not know circleci well (and didn't know it at all when I started this project).
- Python un-updatable, suggestions?
-
Comparison of Python TOML parser libraries
flit
-
How to make a Python package in 2021
I hadn't heard of flit, it does seem like it's not brand new on the scene, however it is primarily a single contributor:
https://github.com/takluyver/flit/graphs/contributors
With a title like this, I'd be expecting to see an article describing the latest tools and recommendations from the PyPA.
mkdocs-material
-
🚚 Building MVPs You Won’t Hate
Material Mk-Docs by Martin Donath works well if you prefer python.
-
The Open Source Sustainability Crisis
https://squidfunk.github.io/mkdocs-material/
I'm an 'outsider', but from from the outside the Material For MkDocs Project looks like a very well managed open source project.
Martin Donath's project uses a 'sponsorware' release strategy to generate donations.
From my vantage point it seems to be working pretty well.
- Release Mkdocs-Material-9.5.0
- Agora a nossa Megathread possui um novo visual!
-
Ask HN: What's the best place to start a newsletter?
I just recently went through this decision process. My aim is to write code and math oriented posts so I need good support for nice syntax highlighting (at least colored) and mathjax (preferable) or katex. Substack is the most popular newsletter platform but fails at these two criteria. I love how math and syntax highlighting (plus numerous other features) work in MkDocs Material, which recently added a Blog plugin.
I wanted to combine the best of both: Substack as an amazing email social network, and MkDocs Material’s awesome look. So I’ve gone with using Substack as the core platform which I use to manage subscribers, and use it to post either math/code-free posts or a short teasers pointing to my main blog site on MkDocs Material when I need to show math/code
https://squidfunk.github.io/mkdocs-material/
- Material for MkDocs – Documentation that simply works
- Features tied to 'Piri Piri' funding goal
- MdBook – Create book from Markdown files. Like Gitbook but implemented in Rust
-
Changing CMS from Wordpress to ?
I've been migrating content to MKDocs (Material) over the last few months, so feel fairly qualified on this subject. It's somewhat limited in terms of navigation, but can probably handle 400-500 pages; you can see how navigation works in the link. Otherwise, it can handle most, if not all, the tasks you've listed.
- Kann man von Open Source leben? Interview mit Martin Donath, der von Open Source lebt.
What are some alternatives?
Poetry - Python packaging and dependency management made easy
Docusaurus - Easy to maintain open source documentation websites.
pip - The Python package installer
sphinx - The Sphinx documentation generator
Pipenv - Python Development Workflow for Humans.
MkDocs - Project documentation with Markdown.
python-lib - Opinionated cookiecutter template for creating a new Python library
mkdocstrings - :blue_book: Automatic documentation from sources, for MkDocs.
tomli - A lil' TOML parser
Read the Docs - The source code that powers readthedocs.org
laravel-websockets-example - Quick example of a docker stack for laravel-websockets
mike - Manage multiple versions of your MkDocs-powered documentation via Git