feat(docs): add development build to documentation

pull/89/head
Vladimir Lugovsky 2016-06-10 21:21:04 +03:00
parent 6c4f1b670b
commit 9c53d32e84
5 changed files with 100 additions and 3 deletions

View File

@ -25,7 +25,9 @@
"perPage": 3,
"groupSort": {
"Quick Start": 1000,
"Customization": 900
"Customization": 900,
"Components": 800,
"Other": 100
}
}
}

View File

@ -0,0 +1,37 @@
---
title: Downloads
author: vl
sort: 900
group: Other
template: article.jade
---
If you have problems installing node.js and/or other tools to build and run BlurAdmin on your machine and you just want to download html/js/css files, you can find links for download on this page.
Development (non-compressed) files can be found in `{ARCHIVE_ROOT}/blur-admin-{VERSION}/dev-release` directory. Compressed files are in `{ARCHIVE_ROOT}/blur-admin-{VERSION}/release` directory.
Then you can just open `index.html` to view your local version.
**Please note**: *As chrome doesn't support AJAX requests, when you open HTML file via **file** protocol, you might need to disable web security to have your template running.*
Sample command on OS X:
```bash
open -a Google\ Chrome --args --disable-web-security --user-data-dir=~/ChromeDevSession/
```
Sample command on Linux:
```bash
google-chrome --user-data-dir="~/chrome-dev-session" --disable-web-security
```
Sample command on Windows:
```bash
start chrome --user-data-dir="C:/Chrome dev session" --disable-web-security
```
## Links for downloads
[BlurAdmin 1.2.0](/blur-admin/downloads/blur-admin-1.2.0.zip)

View File

@ -14,6 +14,7 @@ var gutil = require('gulp-util');
exports.paths = {
src: 'src',
dist: 'release',
devDist: 'dev-release',
tmp: '.tmp',
e2e: 'e2e'
};

57
gulp/devRelease.js Normal file
View File

@ -0,0 +1,57 @@
'use strict';
var path = require('path');
var gulp = require('gulp');
var conf = require('./conf');
var $ = require('gulp-load-plugins')({
pattern: ['gulp-*', 'main-bower-files']
});
var _ = require('lodash');
gulp.task('dev-fonts', function () {
return gulp.src($.mainBowerFiles())
.pipe($.filter('**/*.{eot,svg,ttf,woff,woff2}'))
.pipe($.flatten())
.pipe(gulp.dest(path.join(conf.paths.devDist, 'fonts')));
});
gulp.task('dev-copy-lib', function () {
var assets = require('wiredep')(_.extend({}, conf.wiredep));
var srcList = [];
srcList.push.apply(srcList, assets.js);
srcList.push.apply(srcList, assets.css);
return gulp
.src(srcList/*, { base: '.' }*/)
/* .pipe($.rename(function (p) {
p.dirname = p.dirname.replace(/\\/g, '/').replace('bower_components/', '');
if (p.dirname.indexOf('/') !== -1) {
p.dirname = p.dirname.substr(0, p.dirname.indexOf('/'));
}
}))*/
.pipe(gulp.dest(path.join(conf.paths.devDist, 'lib')));
});
gulp.task('dev-css-replace', ['dev-copy-assets'], function() {
return gulp.src(path.join(conf.paths.devDist, '*.html'))
.pipe($.replace(/<link rel="stylesheet" href="\.\.\/bower_components\/.*\/(.*)"\s*?\/>/g, '<link rel="stylesheet" href="lib/$1" >'))
.pipe(gulp.dest(conf.paths.devDist));
});
gulp.task('dev-js-replace', ['dev-copy-assets'], function() {
return gulp.src(path.join(conf.paths.devDist, '.html'))
.pipe($.replace(/<script src="\.\.\/bower_components\/.*\/(.*)"\s*?>/g, '<script src="lib/$1">'))
.pipe(gulp.dest(conf.paths.devDist));
});
gulp.task('dev-copy-assets', ['inject', 'dev-copy-lib', 'dev-fonts'], function () {
return gulp
.src([
conf.paths.src + '/**/*',
path.join(conf.paths.tmp, '/serve/**/*')
])
.pipe(gulp.dest(conf.paths.devDist));
});
gulp.task('dev-release', ['dev-css-replace', 'dev-js-replace']);

View File

@ -6,7 +6,7 @@ var zip = require('gulp-zip');
var prompt = require('gulp-prompt');
var rename = require('gulp-rename');
gulp.task('marketplace-release', ['build'], function () {
gulp.task('marketplace-release', ['build', 'dev-release'], function () {
return gulp.src('')
.pipe(prompt.prompt({
type: 'input',
@ -15,7 +15,7 @@ gulp.task('marketplace-release', ['build'], function () {
}, function (res) {
var nameAndVersion = 'blur-admin-' + res.version;
return gulp
.src(['src/**', 'release/**', 'gulp/**', 'bower.json', 'gulpfile.js', 'package.json', 'README.md', '.gitignore'], {base: "."})
.src(['src/**', 'release/**', 'dev-release/**', 'gulp/**', 'bower.json', 'gulpfile.js', 'package.json', 'README.md', '.gitignore'], {base: "."})
.pipe(rename(function (path) {
path.dirname = nameAndVersion + '/' + path.dirname;
}))