Skip to content

Commit a5b2240

Browse files
committed
add docs
1 parent 3d4b01c commit a5b2240

File tree

3 files changed

+127
-0
lines changed

3 files changed

+127
-0
lines changed

docs/about.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
# ChangeLog
2+
3+
## [v1.2.0](https://github.com/wuyue92tree/django-adminlte-ui/releases/tag/1.2.0)
4+
5+
- add models with options;
6+
- add general_option.html to manager general option;
7+
- setup app label to `django_admin_settings`;
8+
- register and add general_option into menu;
9+
- add docs.
10+
11+
## [v1.1.1](https://github.com/wuyue92tree/django-adminlte-ui/releases/tag/1.1.1)
12+
13+
- fix filter and search issue at change_list.html, consult django-suit.
14+
15+
## [v1.1.0](https://github.com/wuyue92tree/django-adminlte-ui/releases/tag/1.1.0)
16+
17+
- add pages [ delete_selected_confirmation.html,add object_history.html,404.html,500.html]
18+
- update layout when fieldset.name is not none;
19+
- update support default block extrahead extrastyle。
20+
21+
# FAQ
22+
23+
nothing

docs/index.md

Lines changed: 99 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
1+
# Welcome to django-adminlte-ui
2+
3+
[![PyPI Version](https://img.shields.io/pypi/v/django-adminlte-ui.svg)](https://pypi.python.org/pypi/django-adminlte-ui)
4+
[![Download Status](https://img.shields.io/pypi/dm/django-adminlte-ui.svg)](https://pypi.python.org/pypi/django-adminlte-ui)
5+
[![Build Status](https://api.travis-ci.org/wuyue92tree/django-adminlte-ui.svg)](https://travis-ci.org/wuyue92tree/django-adminlte-ui)
6+
7+
django-adminlte is a django admin theme base on adminlte
8+
9+
adminlte version: 2.3.6
10+
11+
12+
## Helper
13+
14+
- if you have good ideas, just contact me.
15+
- if you find some bug, just add an issue.
16+
- if you think this project is good, just star and fork, make it better 🍉.
17+
18+
19+
## Install
20+
21+
```
22+
pip install django-adminlte-ui
23+
```
24+
25+
## Setup
26+
27+
```
28+
# settings.py
29+
30+
INSTALLED_APPS = [
31+
'adminlteui',
32+
'django.contrib.admin',
33+
'django.contrib.auth',
34+
'django.contrib.sites',
35+
'django.contrib.sitemaps',
36+
'django.contrib.contenttypes',
37+
'django.contrib.sessions',
38+
'django.contrib.messages',
39+
'django.contrib.staticfiles',
40+
...
41+
]
42+
```
43+
44+
## Init models
45+
```
46+
python manage.py migrate django_admin_settings
47+
```
48+
49+
## Guides
50+
51+
### General Option
52+
53+
dynamic setup your site base on table `django_admin_settings_options`.
54+
55+
support options:
56+
57+
- Site Title
58+
- Site Header
59+
- Site Logo
60+
- Welcome Sign
61+
62+
### Options
63+
64+
this options in your db, named `django_admin_settings_options`, after do migrate.
65+
66+
you can also add your custom option into this table, and use it by templatetags
67+
`adminlte_options` with function `get_adminlte_option`.
68+
69+
options table has a valid field to control your option work or not.
70+
71+
72+
example:
73+
74+
```
75+
# adminlte/general_option.html
76+
77+
{% load adminlte_options %}
78+
79+
# here my option_name is site_title, you can custom yourself.
80+
{% get_adminlte_option 'site_title' as adminlte_site_title %}
81+
{% if adminlte_site_title.valid %}
82+
{{ adminlte_site_title.site_title }}
83+
{% else %}
84+
{{ site_title|default:_('Django site admin') }}
85+
{% endif %}
86+
87+
```
88+
89+
before custom option, you should known what adminlte has used.
90+
91+
- site_title
92+
- site_header
93+
- site_logo
94+
- welcome_sign
95+
96+
97+
### Menu
98+
99+
coming soon...

mkdocs.yml

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
site_name: django-adminlte-ui
2+
nav:
3+
- Home: index.md
4+
- About: about.md
5+
#theme: readthedocs

0 commit comments

Comments
 (0)