clean fix

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

View File

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

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 4. It'll rebuild the sphinx docs anytime it notices a change to .rst, .html, .js
or .css files. 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 files and rebuild a new distribution, compressing the css and cleaning out
extraneous files. extraneous files. Please do this before you send in a PR.
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.
TODO TODO
==== ====

File diff suppressed because one or more lines are too long