Skip to content

Instantly share code, notes, and snippets.

@timani
Created June 28, 2016 00:35
Show Gist options
  • Save timani/df83c5e0c06b9e67c531a47688316ddc to your computer and use it in GitHub Desktop.
Save timani/df83c5e0c06b9e67c531a47688316ddc to your computer and use it in GitHub Desktop.
tmunyaradzi:docs-book-cloudfoundry tmunyaradzi$ bookbinder
pwd
Commands:
bookbinder --help # Print this message
bookbinder --version # Print the version of bookbinder
bookbinder bind <local|remote> [options] # Bind the sections specified in config.yml from <local> or <remote> into the final_app directory
bookbinder generate <book_name> # Generate a skeleton book that can be bound with "bookbinder bind"
bookbinder imprint <local|remote> [options] # Generate a PDF for a given book
bookbinder punch <git tag> # Apply the specified <git tag> to your book, sections, and layout repo
bookbinder update_local_doc_repos # Run `git pull` on all sections that exist at the same directory level as your book directory
bookbinder watch # Bind and serve a local book, watching for changes
tmunyaradzi:docs-book-cloudfoundry tmunyaradzi$ pwd
/Users/tmunyaradzi/Pivotal/docs-book-cloudfoundry
tmunyaradzi:docs-book-cloudfoundry tmunyaradzi$ cd ..
tmunyaradzi:Pivotal tmunyaradzi$ bundle exec bookbinder generate blog
Could not locate Gemfile or .bundle/ directory
tmunyaradzi:Pivotal tmunyaradzi$ ls -la
total 16
drwxr-xr-x 12 tmunyaradzi staff 408 May 31 22:24 .
drwxr-xr-x+ 35 tmunyaradzi staff 1190 May 31 21:19 ..
-rw-r--r--@ 1 tmunyaradzi staff 6148 Apr 3 21:58 .DS_Store
drwxr-xr-x 7 tmunyaradzi staff 238 May 7 15:20 GSS
drwxr-xr-x 14 tmunyaradzi staff 476 May 1 18:20 bosh-lite
drwxr-xr-x 28 tmunyaradzi staff 952 May 1 18:04 cf-release
drwxr-xr-x 4 tmunyaradzi staff 136 May 22 23:51 concourse
drwxr-xr-x 19 tmunyaradzi staff 646 Jun 19 22:42 docs-book-cloudfoundry
drwxr-xr-x 7 tmunyaradzi staff 238 May 31 22:25 docs-layout-repo
drwxr-xr-x 14 tmunyaradzi staff 476 May 1 18:18 learn-bosh-release
drwxr-xr-x@ 10 tmunyaradzi staff 340 Apr 3 22:00 pcfdev-v0.13.0
drwxr-xr-x 16 tmunyaradzi staff 544 May 29 00:14 trackerbot
tmunyaradzi:Pivotal tmunyaradzi$ # start of the bookbinder blog
tmunyaradzi:Pivotal tmunyaradzi$ mkdir personal-blog
tmunyaradzi:Pivotal tmunyaradzi$ cd personal-blog/
tmunyaradzi:personal-blog tmunyaradzi$ bundle exec bookbinder generate .
Could not locate Gemfile or .bundle/ directory
tmunyaradzi:personal-blog tmunyaradzi$ bookbinder generate .
Generating book at /Users/tmunyaradzi/Pivotal/personal-blog…
Cannot generate book: directory already exists
tmunyaradzi:personal-blog tmunyaradzi$ ls -la
total 0
drwxr-xr-x 2 tmunyaradzi staff 68 Jun 27 17:11 .
drwxr-xr-x 13 tmunyaradzi staff 442 Jun 27 17:11 ..
tmunyaradzi:personal-blog tmunyaradzi$ bookbinder generate blog
Generating book at /Users/tmunyaradzi/Pivotal/personal-blog/blog…
Fetching gem metadata from https://rubygems.org/
Fetching version metadata from https://rubygems.org/
Fetching dependency metadata from https://rubygems.org/
Resolving dependencies.....
Using i18n 0.7.0
Using json 1.8.3
Using minitest 5.9.0
Using thread_safe 0.3.5
Using addressable 2.4.0
Using ansi 1.5.0
Using multi_json 1.12.1
Using multipart-post 2.0.0
Using builder 3.2.2
Using excon 0.49.0
Using formatador 0.2.5
Using mini_portile2 2.0.0
Using ipaddress 0.8.3
Using sass 3.4.22
Using git 1.2.9.1
Using coffee-script-source 1.10.0
Using execjs 2.7.0
Installing chunky_png 1.3.6
Using rb-fsevent 0.9.7
Using ffi 1.9.10
Using tilt 1.4.1
Using kramdown 1.11.1
Using bundler 1.12.1
Installing mime-types-data 3.2016.0521
Using rack 1.6.4
Using erubis 2.7.0
Using uber 0.0.15
Using thor 0.19.1
Using hike 1.2.3
Using eventmachine 1.2.0.1
Using http_parser.rb 0.6.0
Installing rouge 1.11.1
Using puma 3.4.0
Using rack-rewrite 1.5.1
Using redcarpet 3.2.3
Using libv8 3.16.14.15
Using ref 2.0.0
Using tzinfo 1.2.2
Installing css_parser 1.4.4
Installing elasticsearch-api 1.0.18
Using faraday 0.9.2
Using fog-core 1.40.0
Using nokogiri 1.6.7.2
Installing font-awesome-sass 4.6.2
Using compass-core 1.0.3
Using compass-import-once 1.0.5
Using coffee-script 2.4.1
Using uglifier 2.7.2
Using rb-inotify 0.9.7
Using haml 4.0.7
Installing mime-types 3.1
Using rack-test 0.6.3
Using rack-livereload 0.3.16
Using hooks 0.4.1
Using sprockets 2.12.4
Using em-websocket 0.5.1
Using therubyracer 0.12.2
Using activesupport 4.2.6
Installing elasticsearch-transport 1.0.18
Using fog-json 1.0.2
Using fog-xml 0.1.2
Using xpath 2.0.0
Using compass 1.0.3
Using listen 3.0.8
Using sprockets-helpers 1.1.0
Using sprockets-sass 1.3.1
Installing padrino-support 0.12.8
Installing elasticsearch 1.0.18
Using fog-aws 0.7.6
Using capybara 2.4.4
Installing padrino-helpers 0.12.8
Using middleman-core 3.4.1
Using middleman-sprockets 3.4.2
Using middleman-livereload 3.4.6
Using middleman-syntax 2.1.0
Using middleman 3.4.1
Installing bookbindery 9.12.0
Bundle complete! 1 Gemfile dependency, 77 gems now installed.
Use `bundle show [gemname]` to see where a bundled gem is installed.
Successfully generated book at /Users/tmunyaradzi/Pivotal/personal-blog/blog
tmunyaradzi:personal-blog tmunyaradzi$ ls -la
total 0
drwxr-xr-x 3 tmunyaradzi staff 102 Jun 27 17:12 .
drwxr-xr-x 13 tmunyaradzi staff 442 Jun 27 17:11 ..
drwxr-xr-x 8 tmunyaradzi staff 272 Jun 27 17:12 blog
tmunyaradzi:personal-blog tmunyaradzi$ cd ..
tmunyaradzi:Pivotal tmunyaradzi$ rm -rf personal-blog/
tmunyaradzi:Pivotal tmunyaradzi$ # start of the bookbinder blog
tmunyaradzi:Pivotal tmunyaradzi$ bookbinder generate personal-blog
Generating book at /Users/tmunyaradzi/Pivotal/personal-blog...
Fetching gem metadata from https://rubygems.org/
Fetching version metadata from https://rubygems.org/
Fetching dependency metadata from https://rubygems.org/
Resolving dependencies.....
Using i18n 0.7.0
Using json 1.8.3
Using minitest 5.9.0
Using thread_safe 0.3.5
Using addressable 2.4.0
Using ansi 1.5.0
Using multi_json 1.12.1
Using multipart-post 2.0.0
Using builder 3.2.2
Using excon 0.49.0
Using formatador 0.2.5
Using mini_portile2 2.0.0
Using ipaddress 0.8.3
Using sass 3.4.22
Using git 1.2.9.1
Using coffee-script-source 1.10.0
Using execjs 2.7.0
Using chunky_png 1.3.6
Using rb-fsevent 0.9.7
Using ffi 1.9.10
Using tilt 1.4.1
Using kramdown 1.11.1
Using bundler 1.12.1
Using mime-types-data 3.2016.0521
Using rack 1.6.4
Using erubis 2.7.0
Using uber 0.0.15
Using thor 0.19.1
Using hike 1.2.3
Using eventmachine 1.2.0.1
Using http_parser.rb 0.6.0
Using rouge 1.11.1
Using puma 3.4.0
Using rack-rewrite 1.5.1
Using redcarpet 3.2.3
Using libv8 3.16.14.15
Using ref 2.0.0
Using tzinfo 1.2.2
Using css_parser 1.4.4
Using elasticsearch-api 1.0.18
Using faraday 0.9.2
Using fog-core 1.40.0
Using nokogiri 1.6.7.2
Using font-awesome-sass 4.6.2
Using compass-core 1.0.3
Using compass-import-once 1.0.5
Using coffee-script 2.4.1
Using uglifier 2.7.2
Using rb-inotify 0.9.7
Using haml 4.0.7
Using mime-types 3.1
Using rack-test 0.6.3
Using rack-livereload 0.3.16
Using hooks 0.4.1
Using sprockets 2.12.4
Using em-websocket 0.5.1
Using therubyracer 0.12.2
Using activesupport 4.2.6
Using elasticsearch-transport 1.0.18
Using fog-json 1.0.2
Using fog-xml 0.1.2
Using xpath 2.0.0
Using compass 1.0.3
Using listen 3.0.8
Using sprockets-helpers 1.1.0
Using sprockets-sass 1.3.1
Using padrino-support 0.12.8
Using elasticsearch 1.0.18
Using fog-aws 0.7.6
Using capybara 2.4.4
Using padrino-helpers 0.12.8
Using middleman-core 3.4.1
Using middleman-sprockets 3.4.2
Using middleman-livereload 3.4.6
Using middleman-syntax 2.1.0
Using middleman 3.4.1
Using bookbindery 9.12.0
Bundle complete! 1 Gemfile dependency, 77 gems now installed.
Use `bundle show [gemname]` to see where a bundled gem is installed.
Successfully generated book at /Users/tmunyaradzi/Pivotal/personal-blog
tmunyaradzi:Pivotal tmunyaradzi$ ls -la personal-blog/
total 32
drwxr-xr-x 8 tmunyaradzi staff 272 Jun 27 17:13 .
drwxr-xr-x 13 tmunyaradzi staff 442 Jun 27 17:13 ..
drwxr-xr-x 3 tmunyaradzi staff 102 Jun 27 17:13 .bundle
-rw-r--r-- 1 tmunyaradzi staff 49 Jun 27 17:13 Gemfile
-rw-r--r-- 1 tmunyaradzi staff 4789 Jun 27 17:13 Gemfile.lock
drwxr-xr-x 22 tmunyaradzi staff 748 Jun 27 17:13 bin
-rw-r--r-- 1 tmunyaradzi staff 34 Jun 27 17:13 config.yml
drwxr-xr-x 4 tmunyaradzi staff 136 Jun 27 17:13 master_middleman
tmunyaradzi:Pivotal tmunyaradzi$ cd personal-blog/
tmunyaradzi:personal-blog tmunyaradzi$ cat Gemfile
source "https://rubygems.org"
gem "bookbindery"
tmunyaradzi:personal-blog tmunyaradzi$ cat config.yml
---
book_repo: ''
public_host: ''
tmunyaradzi:personal-blog tmunyaradzi$ ls master_middleman/
build source
tmunyaradzi:personal-blog tmunyaradzi$ ls master_middleman/source/
index.md.erb
tmunyaradzi:personal-blog tmunyaradzi$ ls master_middleman/build/
tmunyaradzi:personal-blog tmunyaradzi$ ls bin/
bookbinder compass haml listen nokogiri pumactl redcarpet sass scss thor
bundler erubis kramdown middleman puma rackup rougify sass-convert sprockets tilt
tmunyaradzi:personal-blog tmunyaradzi$ bookbinder bind local
/usr/local/lib/ruby/gems/2.3.0/gems/bookbindery-9.12.0/lib/bookbinder/config/fetcher.rb:55:in `block in validate': No sections found in your config.yml. Add sections under the appropriate key(s) and try again. (Bookbinder::Config::Checkers::SectionPresenceChecker::NoSectionsError)
from /usr/local/lib/ruby/gems/2.3.0/gems/bookbindery-9.12.0/lib/bookbinder/config/fetcher.rb:53:in `tap'
from /usr/local/lib/ruby/gems/2.3.0/gems/bookbindery-9.12.0/lib/bookbinder/config/fetcher.rb:53:in `validate'
from /usr/local/lib/ruby/gems/2.3.0/gems/bookbindery-9.12.0/lib/bookbinder/config/fetcher.rb:17:in `fetch_config'
from /usr/local/lib/ruby/gems/2.3.0/gems/bookbindery-9.12.0/lib/bookbinder/commands/bind.rb:35:in `run'
from /usr/local/lib/ruby/gems/2.3.0/gems/bookbindery-9.12.0/lib/bookbinder/commands/collection.rb:86:in `bind'
from /usr/local/lib/ruby/gems/2.3.0/gems/bookbindery-9.12.0/lib/bookbinder/cli.rb:39:in `bind'
from /usr/local/lib/ruby/gems/2.3.0/gems/thor-0.19.1/lib/thor/command.rb:27:in `run'
from /usr/local/lib/ruby/gems/2.3.0/gems/thor-0.19.1/lib/thor/invocation.rb:126:in `invoke_command'
from /usr/local/lib/ruby/gems/2.3.0/gems/thor-0.19.1/lib/thor.rb:359:in `dispatch'
from /usr/local/lib/ruby/gems/2.3.0/gems/thor-0.19.1/lib/thor/base.rb:440:in `start'
from /usr/local/lib/ruby/gems/2.3.0/gems/bookbindery-9.12.0/install_bin/bookbinder:5:in `<top (required)>'
from /usr/local/bin/bookbinder:23:in `load'
from /usr/local/bin/bookbinder:23:in `<main>'
tmunyaradzi:personal-blog tmunyaradzi$ git init
Initialized empty Git repository in /Users/tmunyaradzi/Pivotal/personal-blog/.git/
tmunyaradzi:personal-blog tmunyaradzi$ git add .
tmunyaradzi:personal-blog tmunyaradzi$ wget https://raw.githubusercontent.com/cloudfoundry/docs-book-cloudfoundry/master/.gitignore
--2016-06-27 17:35:10-- https://raw.githubusercontent.com/cloudfoundry/docs-book-cloudfoundry/master/.gitignore
Resolving raw.githubusercontent.com... 151.101.24.133
Connecting to raw.githubusercontent.com|151.101.24.133|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 71 [text/plain]
Saving to: '.gitignore'
.gitignore 100%[================================================================================================================>] 71 --.-KB/s in 0s
2016-06-27 17:35:12 (2.18 MB/s) - '.gitignore' saved [71/71]
tmunyaradzi:personal-blog tmunyaradzi$ git add .
tmunyaradzi:personal-blog tmunyaradzi$ git commit -m "Initial commit"
[master (root-commit) b1543a6] Initial commit
26 files changed, 558 insertions(+)
create mode 100644 .bundle/config
create mode 100644 .gitignore
create mode 100644 Gemfile
create mode 100644 Gemfile.lock
create mode 100755 bin/bookbinder
create mode 100755 bin/bundler
create mode 100755 bin/compass
create mode 100755 bin/erubis
create mode 100755 bin/haml
create mode 100755 bin/kramdown
create mode 100755 bin/listen
create mode 100755 bin/middleman
create mode 100755 bin/nokogiri
create mode 100755 bin/puma
create mode 100755 bin/pumactl
create mode 100755 bin/rackup
create mode 100755 bin/redcarpet
create mode 100755 bin/rougify
create mode 100755 bin/sass
create mode 100755 bin/sass-convert
create mode 100755 bin/scss
create mode 100755 bin/sprockets
create mode 100755 bin/thor
create mode 100755 bin/tilt
create mode 100644 config.yml
create mode 100644 master_middleman/source/index.md.erb
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment