A simple Django app to make styleguide
Project description
help you launch your style guide site with KSS syntax
start
pip install django-kss
Installed APP Settings
in settings.py
Add the two app,
INSTALLED_APPS += (
"django_kss",
)
urls.py settings
Routing, add the following two lines in your project’s urls.py
import:
import django_kss.urls
add the url patterns:
url(r’^$’, include(django_kss.urls)),
Writing The KSS in your scss/less/css file
/*
Buttons
Styleguide 1
*/
/*
Your standard form button.
.btn-danger - danger
.btn-warning - warning
.btn-info - info
Example:
<button class="liftedBtn $modifier_class" >按鈕</button>
Styleguide 1.1
*/
.liftedBtn{
@extend .btn;
position: relative;
border-width: 0;
letter-spacing: 1px;
border-bottom-color: rgba(30,30,30,0.3);
border-bottom-width: 0;
transition: all 0.2s;
bottom: 0;
&:hover{
bottom: $strong-border-width;
border-bottom-width: $strong-border-width;
}
}
extend styleguide.html
some times, you need to use extra css or js in your style guide. so the default template is not enough. you can just use the following way to make a better style guide
put the following html in your any template folder
{% extends 'styleguide.html' %}
{% load compress %}
{% load staticfiles %}
{% block style %}
{% compress css %}
<link rel="stylesheet" type="text/x-scss" href="{% static 'css/ntu.scss' %}">
{% endcompress %}
{% endblock %}
{% block bottom %}
<script src="{% static 'js/bootstrap.min.js' %}"></script>
{% endblock %}
in your views.py, just specify the template
from django_kss.views import AutoStyleGuideView
class StyleGuideView(AutoStyleGuideView):
template_name = 'filename you like .html'
specify your the view in your urls.py ( replace the package name with yours )
url(r'^style_guide/(?P<section>\d*)$', style.views.StyleGuideView.as_view(), name='styleguide'),
Use the The Preconfigured Django Server
git clone https://github.com/timtan/django_kss
cd django_kss
virtualenv venv
source venv/bin/activate
pip install -r requirements.txt
cd django_kss_project
python manage.py runserver
refer the KSS Related settings’s section to full fill your need.
Feel Free to submit issue. I use the app frequently and happy to know if you like it.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django-kss-0.2.0.macosx-10.10-intel.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 961002ba68f7faf10787f8cc962d9c3ff462c1d3d9180eec6207168da202b2e2 |
|
MD5 | 0301b74ecdb5a40d01796f8de410a2ca |
|
BLAKE2b-256 | 15a992a6404c9a58511d3a35dc38238529bc0a42e21a875449fc49085aeb5e48 |