v0.3.2

Generated navigation improvements and documentation
Inner navigation for subheadings and current section highlight
404 page
Initial .src files support
Clarify enchancements, now runs fast with jsdom and phantomjs is optional
New code highlighter (prism.js)
/client -> /client-side
Grunt task renamed - deployServer -> deployRemote
Less Middleware

Author: robhrt7

.gitignore

@@ -8,10 +8,10 @@ node_modules
 /build
 
 # Git ignore fo initing
-!/client/init/.gitignore
+!/client-side/init/.gitignore
 
 # Custom client-side plugins folder, managed with volo packet manager
-/client/plugins
+/client-side/plugins
 
 # Custom user folder for Source server side
 /user

Gruntfile.js

@@ -1,8 +1,10 @@
 # Source - Front-end documentation engine
 
-**v.0.3.1**
+**v.0.3.2**
 
-Main project aim is to give front-end development team a **best tool** for documenting web interfaces and **for productive team work**.
+The most powerful tool for documenting web interfaces and building productive team work.
+
+Source powered workflow allows developers to write directly **in the documentation**, it combines front-end interfaces building with documentation process and gives us powerful features for productive development and team work.
 
 Documentation engine originally was developed at [Odnoklassniki.ru](http://corp.mail.ru/en/communications/odnoklassniki) front-end developers team and **is recommended for big and middle sized projects**, expecially for fast growing web portals.
 
@@ -15,17 +17,17 @@ ___
 
 ## Updates
 * 23.09.13. Published [video recording](http://www.youtube.com/watch?v=3HNW5Bru0Ws) of Source engine presentation from [RIT++](http://ritconf.ru/) 2013 (RU)
-* 09.10.13. Engine [presentation](http://rhr.me/pres/source-min/) on [Fronteers Jam](http://fronteers.nl/congres/2013/jam-session) (video will be available soon)
+* 09.10.13. Engine [presentation](http://rhr.me/pres/source-min/) on [Fronteers Jam](http://fronteers.nl/congres/2013/jam-session) ([video](https://vimeo.com/77989211))
+* 31.12.13. **0.3.2** release
 
 ## Upcoming updates
 
-* Video recording of engine presentation with live demo in english 
 * Open project blog with news, updates and best practises
 * Markdown support in spec pages
-* .src files for easier spec pages creation (v.0.3.2)
 * Screencasts and engine usage demos
 * Full english documentation stack for core API
 * Auto spec pages builder
+* Comments plugins major updates
 
 ___
 

README.md

@@ -7,14 +7,28 @@
 /* Module dependencies */
 var express = require('express')
     , colors = require('colors')
-    , fs = require('fs');
+    , fs = require('fs')
+    , lessMiddleware = require('less-middleware')
+    , os = require('os')
+    , ejs = require('ejs')
+    , headerFooter = require('./core/headerFooter');
 
 global.app = express();
 global.opts = require('./core/options/');
 
 global.app.set('views', __dirname + '/core/views');
 global.app.set('specs path', __dirname + '/' + global.opts.common.pathToSpecs);
 
+/* LESS processing */
+//TODO: add config and move to other module, and add configurable varibles (/public folder etc)
+var tmpDir = os.tmpDir();
+global.app.use(lessMiddleware({
+    src: global.app.get('specs path'),
+    dest: tmpDir,
+    force: true
+}));
+/* /LESS processing */
+
 /*  Clarify module */
 var clarify = require('./core/clarify');
 app.use(clarify);
@@ -36,9 +50,6 @@ global.app.use(logErrors);
 global.app.use(clientErrorHandler);
 global.app.use(errorHandler);
 
-/* serve static content */
-global.app.use(express.static(global.app.get('specs path')));
-
 try {
     /* Routes */
     global.routes = require('./core/routes');
@@ -53,6 +64,28 @@ try {
     process.exit(e.code);
 }
 
+/* serve static content */
+global.app.use(express.static(global.app.get('specs path')));
+app.use(express.static(tmpDir));
+
+app.use(function(req, res, next){
+
+	var path = req.url.replace('/index.html', '');
+
+	if (req.accepts('html')) {
+
+        var headerFooterHTML = headerFooter.getHeaderAndFooter();
+		res.render(__dirname + '/core/views/404.ejs', {
+			section: path,
+            header: headerFooterHTML.header,
+            footer: headerFooterHTML.footer
+		})
+
+		return;
+	}
+
+});
+
 if (!module.parent) {
     global.app.listen(80);
     console.log('[SOURCE] is working on 80 port...'.blue);

app.js

@@ -0,0 +1 @@
+Client-side part of Source engine, read more about file structure in [docs](http://sourcejs.com/docs/base/#2!).

client-side/README.md

@@ -5,7 +5,7 @@
 <!--[if gt IE 9]><!--> <html> <!--<![endif]-->
 <head>
     <meta charset="UTF-8">
-    <meta http-equiv="X-UA-Compatible" content="IE=10">
+    <meta http-equiv="X-UA-Compatible" content="IE=edge">
     <meta name="source-page-role" content="navigation">
 
     <title>Source!</title>
@@ -25,8 +25,6 @@ <h1>Source - Front-end Documentation Engine</h1>
 
     <div class="source_col">
         <div class="source_catalog" data-nav="docs">
-            <h2><a class="source_a_bl" href="/docs">Documentation and Examples</a></h2>
-
             <ul class="source_catalog_list">
                 <!--Navigation generated dynamically via Global Navigation module-->
                 <img src="/core/i/process.gif" alt="Loading..."/>

client/init/.gitignore renamed to client-side/init/.gitignore

@@ -6,8 +6,12 @@
             <h2>Sorcerers</h2>
             <ul class="source_ul">
                 <li><a class="source_a_l" href="http://twitter.com/operatino_en">Robert Haritonov</a></li>
-                <li><a class="source_a_l" href="http://twitter.com/ostroffsky">Alexey Ostrovsky</a></li>
                 <li><a class="source_a_l" href="mailto:[email protected]">Eugeny Khoroshilov</a></li>
+                <li><a class="source_a_l" href="http://twitter.com/lapynow">Dmitry Lapynow</a></li>
+                <li><a class="source_a_l" href="http://twitter.com/from_anywhere">Ivan Metelev</a></li>
+                <li><a class="source_a_l" href="mailto:[email protected]">Dennis Przendzinski</a></li>
+                <li><a class="source_a_l" href="http://twitter.com/ostroffsky">Alexey Ostrovsky</a></li>
+
                 <li><a class="source_a_l" href="mailto:[email protected]">Juris Pukitis</a></li>
                 <li><a class="source_a_l" href="http://twitter.com/korochinskiy">Anton Korochinsky</a></li>
             </ul>