StarMirror/sol2
1
0
Fork 0
mirror of https://github.com/ThePhD/sol2.git synced 2024-03-22 13:10:44 +08:00
Code Issues Projects Releases Wiki Activity

clean fix

Browse Source
This commit is contained in:
Dave Snider 2013-11-04 09:13:03 -08:00
parent b99bad47b5
commit 0028bbdb83
3 changed files with 12 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
Gruntfile.js
View File

@ -21,14 +21,14 @@ module.exports = function(grunt) {
},
compass: {
prod: {
build: {
options: {
config: 'compass.rb',
environment: 'production',
force: true
}
},
debug: {
dev: {
options: {
config: 'compass.rb',
force: true
@ -52,12 +52,12 @@ module.exports = function(grunt) {
/* Compile sass changes into theme directory */
sass: {
files: ['sass/*.sass', 'bower_components/**/*.sass'],
tasks: ['compass:debug']
tasks: ['compass:dev']
},
/* Changes in theme dir rebuild sphinx */
sphinx: {
files: ['sphinx_rtd_theme/**/*'],
tasks: ['exec:build_sphinx']
tasks: ['clean:build','exec:build_sphinx']
},
/* live-reload the demo_docs if sphinx re-builds */
livereload: {
@ -75,7 +75,7 @@ module.exports = function(grunt) {
grunt.loadNpmTasks('grunt-contrib-clean');
grunt.loadNpmTasks('grunt-open');
grunt.registerTask('default', ['exec:bower_update','clean:build','compass:debug','exec:build_sphinx','connect','open','watch']);
grunt.registerTask('build', ['exec:bower_update','clean:build','compass:prod','exec:build_sphinx']);
grunt.registerTask('default', ['exec:bower_update','clean:build','compass:dev','exec:build_sphinx','connect','open','watch']);
grunt.registerTask('build', ['exec:bower_update','clean:build','compass:build','exec:build_sphinx']);
}

24
README.rst
View File

@ -119,26 +119,12 @@ This default task will do the following **very cool things that make it worth th
4. It'll rebuild the sphinx docs anytime it notices a change to .rst, .html, .js
or .css files.
When you're done with your edits, you can run ``grunt dist`` to clean out the old
Before you send a Pull Request
------------------------------
When you're done with your edits, you can run ``grunt build`` to clean out the old
files and rebuild a new distribution, compressing the css and cleaning out
extraneous files.
Dude, come on, just for a theme?
-------------------------------------
Frontend development is quickly evolving to a package managed system with sane build tools
that are separate from the backend.
Working with a staticly generated system like sphinx is a pain in the ass for a designer because you
need to do so much rebuilding. Tools like grunt_ and sass_ really, really help make my life easier.
While I know you might be used to the simplicity of other sphinx themes that are just built
in CSS, the majority of the sphinx_rtd_theme comes from other libraries and I want to avoid
copy / pasting code in here just to build it.
OK fine, what files should I be editing then?
---------------------------------------------
Edit files in the ``src`` directory only. Primarily you'll want to edit the .html and .sass files.
extraneous files. Please do this before you send in a PR.
TODO
====

2
sphinx_rtd_theme/static/css/theme.css
View File

File diff suppressed because one or more lines are too long