Skip to content

Commit

Permalink
feat(docs): add development build to documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
lugovsky committed Jun 10, 2016
1 parent 6c4f1b6 commit 9c53d32
Show file tree
Hide file tree
Showing 5 changed files with 100 additions and 3 deletions.
4 changes: 3 additions & 1 deletion docs/config.json
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,9 @@
"perPage": 3,
"groupSort": {
"Quick Start": 1000,
"Customization": 900
"Customization": 900,
"Components": 800,
"Other": 100
}
}
}
37 changes: 37 additions & 0 deletions docs/contents/articles/091-downloads/index.md
Original file line number Diff line number Diff line change
@@ -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)

1 change: 1 addition & 0 deletions gulp/conf.js
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ var gutil = require('gulp-util');
exports.paths = {
src: 'src',
dist: 'release',
devDist: 'dev-release',
tmp: '.tmp',
e2e: 'e2e'
};
Expand Down
57 changes: 57 additions & 0 deletions gulp/devRelease.js
Original file line number Diff line number Diff line change
@@ -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']);
4 changes: 2 additions & 2 deletions gulp/marketplace.js
Original file line number Diff line number Diff line change
Expand Up @@ -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',
Expand All @@ -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;
}))
Expand Down

0 comments on commit 9c53d32

Please sign in to comment.