Metadata-Version: 2.0
Name: django-kss
Version: 0.1.6
Summary: A simple Django app to make styleguide
Home-page: https://github.com/timtan/django_kss
Author: Tim Hsu
Author-email: tim.yellow@gmail.com
License: BSD License
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Dist: pykss
Requires-Dist: Pygments

************
introduction
************

help you launch your style guide site with KSS syntax

.. image:: pictures/screenshot.png

======
start
======

    pip install django-kss



Installed APP Settings
==========================

in settings.py

Add the two app,

    INSTALLED_APPS += (

        "django_kss",

        "pykss.contrib.django",

    )


KSS Related Settings
==========================

in settings.py 

Add setting in your project's settings with the two extra config

* PYKSS_DIRS:  Setup source file path, less sass or css
* PYKSS_STATIC_FILES: the full path in your assets. final page use it to show content


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)),



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.


Development
============

計畫可以方便的做 Style Guide.

DRY 要到一個極致。

只有寫 CSS, 接下來，就可以自動產生 Style Guide 的頁面。

CSS -> Generate List, Generate Page

所有的　input 由產生的　css 來做判斷，這樣才能跟所有的　CSS Preprocessor 整合。



計畫：

1. 做成　APP, 整進　Django
2. 畫面可以由 Bootsrap 的　tab 來分段較順手跟簡單。
3. 我們需要設定的，是檔案清單位置，還有 CSS 檔位置。
    * 檔案清單在　setting.py
    * CSS 位置都寫在　Settting.py 集中　setting




