MayBlog is powered by django, here are some instruction on how to run it.
(sudo) pip install -r requirements.txt
For the first time, before you start the application, you need to initialize the datebase which is configured in the settings file and designed in main.models.py
python manage.py migrateIf the models are changed after the datebase is created, you need to run the following commands:
python manage.py makemigrations #create migration script
python manage.py migrate #migrate datebaseI use sqlite in dev settings and mysql in prod settings, if you would like to use postgres, mongodb, etc, install relevant python prerequisite first.
After the datebase is established, you can run the blog with command:
python manage.py runserver 0.0.0.0:8000Then you can visit the blog with url: http://127.0.0.1:8000
When the blog is run, checkout http://127.0.0.1:8000/init to initialize the system
It will create the superuser, user groups(administrator, editor, writer, contributor, and reader), and assign permissions for each group.
You can create a superuser to administer MayBlog in its admin interface:
python manage.py createsuperuserThen, you can administer MayBlog with following admin interface:
-
MayBlog admin: http://127.0.0.1:8000/admin/
-
Django's default admin: http://127.0.0.1:8000/admin2/
-
Login page: http://127.0.0.1:8000/accounts/login/
-
Register page: http://127.0.0.1:8000/accounts/register/ (if
REGISTER_IS_ALLOWEDis set to True in settings)
By default, MayBlog uses dev settings(blog.settings.dev) in blog/settings/dev.py in development environment.
blog.settings.prod is used in product environment and blog.settings.stage is in test environment. You can overwrite these settings or create your custom settings and switch to it.
Just set your settings in bash with export command. For example, if you want to run MayBlog in product environment, you can switch to prod settings like this:
export DJANGO_SETTINGS_MODULE="blog.settings.prod"
I recommend you to deploy MayBlog by Ubuntu + nginx + uwsgi.
Here is an instruction.
Using MayBlog's docker image is another recommended option
If you find a bug or want to add a new feature, just issue me. Want to contribute? Please fork MayBlog and pull request to me.
I'm not good at frontend development, so I used a free bootstrap blog theme. If you can redesign the blog theme and admin interface, I'll appriciate your work very much!