first version

Author: waileung

.gitignore

@@ -0,0 +1,2 @@
+.DS_Store
+node_modules

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 SUPER O2 MAN
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,3 +1,48 @@
-# 编码规范
+# Full-Stack Development Guide 
 
-前端代码规范旨在确保每一行代码易读、易维护，从而形成团队统一编码风格，最终确保项目的专业化输出。
+Installation Guides For Full-Stack Developers Using MAC OS 
+
+## Getting started
+
+Install dependencies:
+
+``` bash
+$ git clone https://github.com/o2team/guide.git
+$ cd guide
+$ npm install
+```
+
+Generate:
+
+``` bash
+$ hexo g
+```
+
+Run server:
+
+``` bash
+$ hexo s --watch
+```
+
+## Deployment
+
+1. Generate and optimize assets
+
+  ```bash
+  gulp
+  ```
+
+2. Deploy to the gh-pages branch
+
+  ```bash
+  hexo deploy
+  ```
+
+## Contributors
+
+- English - [mamboer]
+- 简体中文 - [天哥]
+
+## License
+
+[CC BY 4.0](http://creativecommons.org/licenses/by/4.0/)

_config.yml

@@ -0,0 +1,34 @@
+title: Aotu.io - 前端代码规范
+subtitle: "Front-End Coding Guidelines"
+description: "Best Coding Guidelines For Front-End Developer."
+author: 凹凸实验室
+language: zh-cn
+timezone: UTC
+url: http://aotu.io/guide
+root: /guide/
+permalink: news/:year/:month/:day/:title/
+archive_dir: news
+code_dir: downloads/code
+new_post_name: :year-:month-:day-:title.md # File name of new posts
+post_asset_folder: true
+highlight:
+  enable: true
+  line_number: false
+per_page: 0
+
+theme: navy
+deploy:
+  type: git
+  repo: [email protected]:o2team/guide.git
+  branch: gh-pages
+
+disqus_shortname:
+google_analytics: UA-4910098-10
+baidu_analytics: bb4b770d7fdf4e05245cd1327199d813
+fb_admins: 100000247608790
+swiftype_key: nxhXzi1rDss_9_P_6zBa
+twitter: o2circle
+github: o2team/guide
+gh:
+  user: o2team
+  repo: guide

db.json

@@ -0,0 +1,111 @@
+'use strict';
+
+var gulp    = require('gulp'),
+    $       = require('gulp-load-plugins')(),
+    cssnano = require('cssnano'),
+    yaml    = require('js-yaml'),
+    fs      = require('fs'),
+    cfg     = yaml.safeLoad(fs.readFileSync('_config.yml'));
+
+require('shelljs/global');
+
+var htmlMinifierOptions = {
+  removeComments: true,
+  collapseWhitespace: true,
+  collapseBooleanAttributes: true,
+  removeScriptTypeAttributes: true,
+  removeStyleLinkTypeAttributes: true,
+  removeOptionalTags: true,
+  minifyJS: true,
+  minifyCSS: true
+};
+
+var dirs = {
+  public: 'public',
+  fonts: 'public/fonts',
+  imgs: 'public/img',
+  assetsDir:'public/assets'
+};
+
+gulp.task('useref', ['hexo'], function(){
+
+  return gulp.src('public/**/*.html')
+    .pipe($.useref({
+        searchPath:'public',
+        transformPath: function(filePath) {
+            return filePath.replace(dirs.public + cfg.root, dirs.public + '/');
+        }
+    }))
+    .pipe($.if('*.css', $.postcss([
+      cssnano()
+    ])))
+    .pipe($.if('*.css', $.minifyCss()))
+    .pipe($.if('*.js', $.uglify()))
+    .pipe($.if('*.html', $.htmlMinifier(htmlMinifierOptions)))
+    .pipe(gulp.dest('public'));
+});
+
+gulp.task('rev:media', function(){
+
+    return gulp.src([dirs.fonts + '/**/*', dirs.imgs + '/**/*'], {base: dirs.public})
+        .pipe($.rev())
+        .pipe(gulp.dest(dirs.assetsDir))
+        .pipe($.rev.manifest('rev-media.json'))
+        .pipe(gulp.dest(dirs.assetsDir));
+
+});
+
+gulp.task('rev:scripts', ['useref', 'rev:media'], function(){
+    var manifest = gulp.src(dirs.assetsDir + '/rev-media.json');
+
+    return gulp.src([dirs.public + '/css/dist*.css', dirs.public + '/js/dist*.js'], {base: dirs.public})
+        .pipe($.rev())
+        .pipe($.revReplace({
+            manifest: manifest
+        }))
+        .pipe(gulp.dest(dirs.assetsDir))
+        .pipe($.rev.manifest())
+        .pipe(gulp.dest(dirs.assetsDir));
+
+});
+
+gulp.task('img:min', ['rev:media'], function(){
+
+    var pngquant = require('imagemin-pngquant');
+
+    return gulp.src(dirs.assetsDir + '/img/**/*', {base: dirs.assetsDir})
+        .pipe($.imagemin({
+            progressive: true,
+            svgoPlugins: [{removeViewBox:false}],
+            use:[pngquant()]
+        }))
+        .pipe(gulp.dest(dirs.assetsDir))
+});
+
+gulp.task("rev:replace", ["rev:scripts"], function(){
+    var manifest = gulp.src([dirs.assetsDir + '/rev-*.json']);
+
+    return gulp.src([ dirs.public + "/**/*.html"])
+        .pipe($.revReplace({
+            manifest: manifest,
+            modifyReved:function(fileName){
+                if(fileName.indexOf('/dist') > -1){
+                    //special files proccessed by gulp-useref
+                    fileName = cfg.root + 'assets/' + fileName;
+                }else {
+                    fileName = 'assets/' + fileName; 
+                }
+                return fileName;
+            }
+        }))
+        .pipe(gulp.dest(dirs.public));
+});
+
+gulp.task('hexo', function(){
+   
+   exec('hexo g');
+
+});
+
+gulp.task('img', ['img:min']);
+gulp.task('default', ['rev:replace', 'img']);

gulpfile.js

@@ -0,0 +1,51 @@
+{
+  "name": "hexo-site",
+  "version": "0.0.0",
+  "private": true,
+  "hexo": {
+    "version": "3.1.1"
+  },
+  "scripts": {
+    "build": "hexo generate && gulp"
+  },
+  "dependencies": {
+    "cheerio": "^0.19.0",
+    "hexo": "^3.1.1",
+    "hexo-deployer-git": "0.0.4",
+    "hexo-generator-archive": "^0.1.3",
+    "hexo-generator-feed": "^1.0.3",
+    "hexo-generator-sitemap": "^1.0.1",
+    "hexo-renderer-jade": "^0.1.0",
+    "hexo-renderer-marked": "^0.2.5",
+    "hexo-renderer-stylus": "^0.3.0",
+    "hexo-server": "^0.1.2",
+    "lodash": "^3.10.1",
+    "lunr": "^0.6.0"
+  },
+  "devDependencies": {
+    "cssnano": "^3.3.1",
+    "gulp": "^3.9.0",
+    "gulp-favicons": "^2.1.3",
+    "gulp-html-minifier": "^0.1.6",
+    "gulp-if": "^2.0.0",
+    "gulp-ignore": "^2.0.1",
+    "gulp-image-resize": "^0.7.1",
+    "gulp-imagemin": "^2.4.0",
+    "gulp-load-plugins": "^1.1.0",
+    "gulp-minify-css": "^1.2.1",
+    "gulp-minify-html": "^1.0.4",
+    "gulp-postcss": "^6.0.1",
+    "gulp-rename": "^1.2.2",
+    "gulp-rev": "^6.0.1",
+    "gulp-rev-collector": "^1.0.2",
+    "gulp-rev-replace": "^0.4.2",
+    "gulp-uglify": "^1.5.1",
+    "gulp-useref": "^3.0.0",
+    "imagemin-pngquant": "^4.2.0",
+    "js-yaml": "^3.4.3",
+    "shelljs": "^0.5.3"
+  },
+  "optionalDependencies": {
+    "hexo-browsersync": "^0.1.0"
+  }
+}

package.json

@@ -0,0 +1,2 @@
+title: {{ title }}
+---

scaffolds/page.md

@@ -0,0 +1,2 @@
+title: {{ title }}
+---

scaffolds/post.md

@@ -0,0 +1,76 @@
+'use strict';
+var cheerio;
+
+function bsTOC(str, options) {
+  options = options || {};
+
+  if (!cheerio) cheerio = require('cheerio');
+
+  var $ = cheerio.load(str);
+  var headings = $('h1, h2, h3, h4, h5, h6');
+
+  if (!headings.length) return '';
+
+  var className = options.class || 'nav';
+  var listNumber = options.hasOwnProperty('list_number') ? options.list_number : true;
+  var result = '<ul class="' + className + ' toc-nav">';
+  var lastNumber = [0, 0, 0, 0, 0, 0];
+  var firstLevel = 0;
+  var lastLevel = 0;
+  var i = 0;
+
+  headings.each(function() {
+    var level = +this.name[1];
+    var id = $(this).attr('id');
+    var text = $(this).text();
+
+    lastNumber[level - 1]++;
+
+    for (i = level; i <= 5; i++) {
+      lastNumber[i] = 0;
+    }
+
+    if (firstLevel) {
+      for (i = level; i < lastLevel; i++) {
+        result += '</li></ul>';
+      }
+
+      if (level > lastLevel) {
+        result += '<ul class="' + className + ' '+ className + '-child">';
+      } else {
+        result += '</li>';
+      }
+    } else {
+      firstLevel = level;
+    }
+
+    result += '<li class="' + className + '-item ' + className + '-level-' + level + '">';
+    result += '<a class="' + className + '-link" href="#' + id + '">';
+
+    if (listNumber) {
+      result += '<span class="' + className + '-number">';
+
+      for (i = firstLevel - 1; i < level; i++) {
+        result += lastNumber[i] + '.';
+      }
+
+      result += '</span> ';
+    }
+
+    result += '<span class="' + className + '-text">' + text + '</span></a>';
+
+    lastLevel = level;
+  });
+
+  for (i = firstLevel - 1; i < lastLevel; i++) {
+    result += '</li></ul>';
+  }
+
+  return result;
+};
+/**
+ * boostrap scrollspy compatible toc
+ */
+hexo.extend.helper.register('bstoc', function(str, opts){
+  return bsTOC(str, opts);
+});