Awestruct是非常棒的靜態網站生成框架，他基於Jekyll，使用Ruby語言開發。Awestruct可以根據模板生 成非常漂亮的網站，例如可以用BootStrap或者BluePrint，這兩個大名鼎鼎的東東不用多說了吧，地球人都知 道。廢話不多說，進入主題。安裝Ruby環境
首先安裝一些依賴庫，否則安裝Awestruct會報如下的錯誤 ：
Building native extensions. This could take a while...
.........
ERROR: Error installing 下一代靜態網站生成工具:
ERROR: Failed to build gem native extension. .
/usr/bin/ruby extconf.rb
checking for stdio.h... *** extconf.rb failed ***
Could not create Makefile due to some reason, probably lack of
necessary libraries and/or headers. Check the mkmf.log file for more
details. You may need configuration options.
.
Provided configuration options:
--with-opt-dir
--without-opt-dir
--with-opt-include
--without-opt-include=${opt-dir}/include
--with-opt-lib
--without-opt-lib=${opt-dir}/lib
--with-make-prog
--without-make-prog
--srcdir=.
--curdir
--ruby=/usr/bin/ruby
/usr/share/ruby/mkmf.rb:381:in `try_do': The compiler failed to generate an executable file.
(RuntimeError)
You have to install development tools first.
from /usr/share/ruby/mkmf.rb:506:in `try_cpp'
from /usr/share/ruby/mkmf.rb:931:in `block in have_header'
from /usr/share/ruby/mkmf.rb:790:in `block in checking_for'
from /usr/share/ruby/mkmf.rb:284:in `block (2 levels) in postpone'
from /usr/share/ruby/mkmf.rb:254:in `open'
from /usr/share/ruby/mkmf.rb:284:in `block in postpone'
from /usr/share/ruby/mkmf.rb:254:in `open'
from /usr/share/ruby/mkmf.rb:280:in `postpone'
from /usr/share/ruby/mkmf.rb:789:in `checking_for'
from /usr/share/ruby/mkmf.rb:930:in `have_header'
from extconf.rb:2:in `<main>'
開始安裝依賴庫，用 root 用戶或者 su 執行如下 命令：
yum install -y gcc-c++ patch readline readline-devel zlib zlib-devel libyaml-devel libffi-devel openssl-devel make bzip2 autoconf automake libtool bison iconv-devel
我是 Fedora的粉絲，對不住用其它發行版的童鞋了，請自行根據我列出的安裝包找到對應的系統安裝方法。
安裝Ruby和RubyGems,用 root 用戶或者 su 執行如下命令：
yum install ruby ruby-devel ruby-irb rubygems
Fedora18 Yum源的Ruby非常新，都是目前(2012-12-14)的最新版本，看看安裝的 Ruby版本：
正在安裝 : libyaml-0.1.4-3.fc18.x86_64
1/10
正在安裝 : ruby-libs-1.9.3.327-22.fc18.x86_64 2/10
正在安裝 : ruby-irb-1.9.3.327-22.fc18.noarch 3/10
正在安裝 : rubygem-json-1.6.5-2.fc18.x86_64 4/10
正在安裝 : rubygem-io-console-0.3-22.fc18.x86_64 5/10
正在安裝 : rubygem-bigdecimal-1.1.0-22.fc18.x86_64 6/10
正在安裝 : rubygem-rdoc-3.12-5.fc18.noarch 7/10
正在安裝 : rubygems-1.8.24-3.fc18.noarch 8/10
正在安裝 : ruby-1.9.3.327-22.fc18.x86_64 9/10
正在安裝 : ruby-devel-1.9.3.327-22.fc18.x86_64
安裝Awestruct
Awestruct使用 RubyGems管理安裝，用 root 用戶或者 su 執行如下命令：
gem install 下一代靜態網站生成工具 - -no-ri --no-rdoc
結果報如下錯誤:
Fetching: nokogiri-1.5.5.gem (100%)
ERROR: Error installing 下一代靜態網站生成工具:
invalid gem format for /usr/local/share/gems/cache/nokogiri-1.5.5.gem
這個問題讓 我郁悶了N久時間，Google了大半天，還特意搞了FANQIANG，結果死活裝不上nokogiri。最後通過Yum來解決, 我只能說RubyGems安裝很無恥！還是YUM好！，命令如下：
yum install -y rubygem-nokogiri
再次安裝Awestruct：
yum install -y rubygem-nokogiri
盼望已久的時刻來臨，如果哪位童鞋 看到如下的輸出，Congratulations！
Successfully installed 下一代靜態網站生成工具-0.4.7 17 gems installed
不過別高興太早，先適用下是否OK！用BootStrap模板生產一個新的靜態網站，命令如 下：
下一代靜態網站生成工具 -i -f bootstrap //或者用awestruct --init --framework bootstrap
傻眼了，還是報錯：
[root@localhost kuuyee]# 下一代靜態網站生成工具 -i -f
bootstrap
/usr/local/share/gems/gems/execjs-1.4.0/lib/execjs/runtimes.rb:51:in `autodetect': Could not
find a JavaScript runtime. See https://github.com/sstephenson/execjs for a list of available
runtimes. (ExecJS::RuntimeUnavailable)
from /usr/local/share/gems/gems/execjs-1.4.0/lib/execjs.rb:5:in `<module:ExecJS>'
from /usr/local/share/gems/gems/execjs-1.4.0/lib/execjs.rb:4:in `<top (required)>'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/local/share/gems/gems/coffee-script-2.2.0/lib/coffee_script.rb:1:in `<top
(required)>'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/local/share/gems/gems/coffee-script-2.2.0/lib/coffee-script.rb:1:in `<top
(required)>'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/local/share/gems/gems/awestruct-
0.4.7/lib/awestruct/handlers/coffeescript_handler.rb:8:in `<top (required)>'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/local/share/gems/gems/awestruct-0.4.7/lib/awestruct/handler_chains.rb:14:in
`<top (required)>'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/local/share/gems/gems/awestruct-0.4.7/lib/awestruct/pipeline.rb:2:in `<top
(required)>'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/local/share/gems/gems/awestruct-0.4.7/lib/awestruct/engine.rb:6:in `<top
(required)>'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/local/share/gems/gems/awestruct-0.4.7/lib/awestruct/cli/generate.rb:1:in
`<top (required)>'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/local/share/gems/gems/awestruct-0.4.7/lib/awestruct/cli/invoker.rb:4:in
`<top (required)>'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/local/share/gems/gems/awestruct-0.4.7/bin/awestruct:6:in `<top (required)
>'
from /usr/local/bin/awestruct:23:in `load'
from /usr/local/bin/awestruct:23:in `<main>'
顧名思義，提示沒有JavaScript Runtime。繼續Google，最後一位高人指點說裝個JavaScript引擎就OK，我選擇NodeJS。只可惜NodeJSF沒有 YUM源，只能源碼編譯安裝，無所謂，繼續:
wget -c 'http://nodejs.org/dist/v0.8.16/node-v0.8.16.tar.gz' tar zxvf node-v0.8.16.tar.gz cd node-v0.8.16 ./configure make && make install
又是一陣漫長的等待，搞不明白一個JS框架怎麼要編譯這麼久，無 語！最後編譯完成測試一下：
[root@localhost node-v0.8.16]# node -v v0.8.16
OK,繼續 Awestruct測試：
[root@localhost kuuyee]# 下一代靜態網站生成工具 -i -f bootstrap
/usr/local/share/gems/gems/git-1.2.5/lib/git/lib.rb:700:in `command': git version
2>&1:sh: git: 未找到命令 (Git::GitExecuteError)
from /usr/local/share/gems/gems/git-1.2.5/lib/git/lib.rb:649:in
`current_command_version'
from /usr/local/share/gems/gems/git-1.2.5/lib/git/lib.rb:659:in
`meets_required_version?'
from /usr/local/share/gems/gems/git-1.2.5/lib/git.rb:30:in `<top (required)>'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/local/share/gems/gems/awestruct-0.4.7/lib/awestruct/deploy/base_deploy.rb:2:in
`<top (required)>'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/local/share/gems/gems/awestruct-0.4.7/lib/awestruct/deploy/s3_deploy.rb:1:in
`<top (required)>'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/local/share/gems/gems/awestruct-0.4.7/lib/awestruct/cli/deploy.rb:1:in
`<top (required)>'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/local/share/gems/gems/awestruct-0.4.7/lib/awestruct/cli/invoker.rb:7:in
`<top (required)>'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/share/rubygems/rubygems/custom_require.rb:36:in `require'
from /usr/local/share/gems/gems/awestruct-0.4.7/bin/awestruct:6:in `<top (required)
>'
from /usr/local/bin/awestruct:23:in `load'
from /usr/local/bin/awestruct:23:in `<main>'
竟然還TMD報錯，不過這回不用急 ，只是提示沒裝Git，好辦！那就裝呗：
yum install git
再繼續Awestruct：
[root@localhost kuuyee.org]# 下一代靜態網站生成工具 -i -f bootstrap
Create directory: /root/git_project/kuuyee.org/_config
Create directory: /root/git_project/kuuyee.org/_layouts
Create directory: /root/git_project/kuuyee.org/_ext
Create file: /root/git_project/kuuyee.org/_ext/pipeline.rb
Create directory: /root/git_project/kuuyee.org/stylesheets
directory _site/stylesheets/
directory images/
directory javascripts/
create stylesheets/styles.scss
create images/glyphicons-halflings.png
create images/glyphicons-halflings-white.png
create javascripts/bootstrap-alert.js
create javascripts/bootstrap-button.js
create javascripts/bootstrap-carousel.js
create javascripts/bootstrap-collapse.js
create javascripts/bootstrap-dropdown.js
create javascripts/bootstrap-modal.js
create javascripts/bootstrap-popover.js
create javascripts/bootstrap-scrollspy.js
create javascripts/bootstrap-tab.js
create javascripts/bootstrap-tooltip.js
create javascripts/bootstrap-transition.js
create javascripts/bootstrap-typeahead.js
create _site/stylesheets/styles.css
Now you're 下一代靜態網站生成工具!
To generate your site continuous during development, simply run:
下一代靜態網站生成工具 -d
and visit your site at
http://localhost:4242/
Create file: /root/git_project/kuuyee.org/_layouts/base.html.haml
Create file: /root/git_project/kuuyee.org/index.html.haml
Congratulations! 這回真的恭喜 你了！趕緊部署一下：
[root@localhost kuuyee]# 下一代靜態網站生成工具 -d
Unable to locate profile: development
Using profile: NONE
Generating site: http://localhost:4242
Generating: /1003/awestruct-sample/_site/images/glyphicons-halflings-white.png
Generating: /1003/awestruct-sample/_site/images/glyphicons-halflings.png
Generating: /1003/awestruct-sample/_site/index.html
Generating: /1003/awestruct-sample/_site/javascripts/bootstrap-alert.js
/usr/local/share/gems/gems/awestruct-0.4.7/lib/awestruct/handlers/interpolation_handler.rb:35:
Use RbConfig instead of obsolete and deprecated Config.
Generating: /1003/awestruct-sample/_site/javascripts/bootstrap-button.js
Generating: /1003/awestruct-sample/_site/javascripts/bootstrap-carousel.js
Generating: /1003/awestruct-sample/_site/javascripts/bootstrap-collapse.js
Generating: /1003/awestruct-sample/_site/javascripts/bootstrap-dropdown.js
Generating: /1003/awestruct-sample/_site/javascripts/bootstrap-modal.js
Generating: /1003/awestruct-sample/_site/javascripts/bootstrap-popover.js
Generating: /1003/awestruct-sample/_site/javascripts/bootstrap-scrollspy.js
Generating: /1003/awestruct-sample/_site/javascripts/bootstrap-tab.js
Generating: /1003/awestruct-sample/_site/javascripts/bootstrap-tooltip.js
Generating: /1003/awestruct-sample/_site/javascripts/bootstrap-transition.js
Generating: /1003/awestruct-sample/_site/javascripts/bootstrap-typeahead.js
Analyzing: /1003/awestruct-sample/_site/stylesheets/styles.css
[Listen warning]:
Missing dependency 'rb-inotify' (version '~> 0.8.8')!
Please run the following to satisfy the dependency:
gem install --version '~> 0.8.8' rb-inotify
.
For a better performance, it's recommended that you satisfy the missing dependency.
Listen will be polling changes. Learn more at https://github.com/guard/listen#polling-
fallback.
.
>> Thin web server (v1.4.1 codename Chromeo)
>> Maximum connections set to 1024
>> Listening on 0.0.0.0:4242, CTRL+C to stop
打開 http://localhost:4242/ 看看吧！
BootStrap網站模板
細心的童鞋一定會注意到部署輸出有警告，我是屬於不想看到任何警告的 人，所以還得繼續，清楚警告：
gem install --version '~> 0.8.8' rb-inotify
再次部署訪問就不會有警告了！
大功告成！祝願各位童鞋安裝成功！
