Update README.md
This commit is contained in:
parent
26592543e1
commit
8cbe3fc83e
1 changed files with 3 additions and 30 deletions
33
README.md
33
README.md
|
|
@ -1,39 +1,12 @@
|
||||||
# 🍔 moku.blog
|
this is just my fork of moku.blog i self-hosted except i removed the image fields bc they dont work for some reason
|
||||||
|
|
||||||
[](https://github.com/astral-sh/ruff)
|
[](https://github.com/astral-sh/ruff)
|
||||||
[](https://docs.djangoproject.com/en/5.0/)
|
[](https://docs.djangoproject.com/en/5.0/)
|
||||||
[](https://docs.python.org/3.12/)
|
[](https://docs.python.org/3.12/)
|
||||||
[](LICENSE)
|
[](LICENSE)
|
||||||
[](https://github.com/m5ka/moku.blog/actions)
|
[](https://github.com/m5ka/moku.blog/actions)
|
||||||
|
|
||||||
**moku.blog** is a small-web community for food enthusiasts.
|
**cheesy** is a small-web community for food enthusiasts.
|
||||||
|
|
||||||
## 🥐 behind the name
|
|
||||||
**moku** is the [toki pona](https://tokipona.org/) word for "food", "drink", "eat" or, really, anything to do with consuming. it comes from the japanese onomatopoeia [もぐもぐ](https://en.wiktionary.org/wiki/%E3%82%82%E3%81%90%E3%82%82%E3%81%90#Japanese) (_mogu-mogu_) which represents the sound of chewing.
|
|
||||||
|
|
||||||
## 🍕 contributing
|
|
||||||
it's great that you want to help out! a good place to start is checking in [issues](https://github.com/m5ka/moku.blog/issues) to see if what you're thinking about has already been discussed.
|
|
||||||
|
|
||||||
### pre-requisites
|
|
||||||
* python 3.12 and [poetry](https://python-poetry.org/)
|
|
||||||
* postgresql
|
|
||||||
|
|
||||||
### setting up the environment
|
|
||||||
the environment is all managed by poetry so it's pretty easy to get started once you have poetry set up.
|
|
||||||
```sh
|
|
||||||
poetry install --with dev,test
|
|
||||||
```
|
|
||||||
|
|
||||||
if you get an error about `psycopg2`, make sure you have the system package `libpq-dev` installed on your system.
|
|
||||||
|
|
||||||
### code-style
|
|
||||||
all our code is linted and formatted by [ruff](https://docs.astral.sh/ruff/) so it's important to make sure any changes you make are compliant.
|
|
||||||
|
|
||||||
```sh
|
|
||||||
poetry run ruff check .
|
|
||||||
poetry run ruff format --check .
|
|
||||||
```
|
|
||||||
|
|
||||||
if you want ruff to auto-format your code, you can use `poetry run ruff format .`
|
|
||||||
|
|
||||||
## 🧁 license
|
## 🧁 license
|
||||||
moku.blog's code is licensed under the [bsd 2-clause license](LICENSE), which more or less means you're free to do whatever you want with it so long as any copies or modifications you make are under the same license.
|
moku.blog's code is licensed under the [bsd 2-clause license](LICENSE), which more or less means you're free to do whatever you want with it so long as any copies or modifications you make are under the same license.
|
||||||
Loading…
Reference in a new issue