This is an automated email from the ASF dual-hosted git repository.
zregvart pushed a commit to branch website
in repository https://gitbox.apache.org/repos/asf/camel.git
commit 7222af66962a20991d1664f99a9ba15cfef5034b
Author: Zoran Regvart <zregv...@apache.org>
AuthorDate: Mon Jul 3 23:59:06 2017 +0200
CAMEL-11492 New Camel website - added README.md
---
camel-website/README.md | 40 ++++++++++++++++++++++++++++++++++++++++
1 file changed, 40 insertions(+)
diff --git a/camel-website/README.md b/camel-website/README.md
new file mode 100644
index 0000000..8434e32
--- /dev/null
+++ b/camel-website/README.md
@@ -0,0 +1,40 @@
+# Camel Website
+
+This is a site generator project for Apache Camel. It generates static HTML and
+resources that are to be published. Tools used to generate the website:
+ - [Gulp](http://gulpjs.com/) a task automation tool. It is used to gather
+ documentation files from the Camel source tree and filter and copy them into
+ the `content` folder.
+ - [Hugo](https://gohugo.io) a static site generator. Simplified, it takes the
+ documentation from the `content` folder and applies templates from `layouts`
+ folder and together with any resources in `static` folder generates output
in
+ the `public` folder.
+ - [Yarn](https://yarnpkg.io) - JavaScript dependency management and script
+ runner. Used to bring in all tooling (Gulp, Hugo, Webpack, ...) and other
+ dependencies (Skeleton CSS framework for example) and run `build` and
`watch`
+ scripts.
+ - [Webpack](https://webpack.js.org/) - JavaScript and CSS module bundler, it
+ generates JavaScript in `static/js` and CSS in `static/css` bundles from
+ `src/scripts` and `src/stylesheets` respectively.
+
+## Building the website
+
+To build the website run:
+
+ $ yarn // needed only once, or if dependencies change
+ $ yarn build // to perform the build
+
+This should generate the website in the `public` folder.
+
+## Working on the website
+
+When working on the website it is nice to see the effects of the change
+immediately, to that end you can run:
+
+ $ yarn // needed only once, or if dependencies change
+ $ yarn build // to perform the build
+ $ yarn serve // serve the website on http://localhost:1313 and react on \
+ changed files
+
+If a file is changed tools react on that change and a script present in the
+website performs a reload (livereload).
