Class: Jekyll::Commands::Build

Inherits:
Jekyll::Command show all
Defined in:
lib/jekyll/commands/build.rb

Class Method Summary collapse

Methods inherited from Jekyll::Command

add_build_options, configuration_from_options, inherited, process_site, subclasses

Class Method Details

.build(site, options) ⇒ Object

Build your Jekyll site.

site - the Jekyll::Site instance to build options - A Hash of options passed to the command

Returns nothing.



51
52
53
54
55
56
57
58
59
60
61
62
# File 'lib/jekyll/commands/build.rb', line 51

def build(site, options)
  t = Time.now
  source      = options['source']
  destination = options['destination']
  incremental = options['incremental']
  Jekyll.logger.info "Source:", source
  Jekyll.logger.info "Destination:", destination
  Jekyll.logger.info "Incremental build:", (incremental ? "enabled" : "disabled. Enable with --incremental")
  Jekyll.logger.info "Generating..."
  process_site(site)
  Jekyll.logger.info "", "done in #{(Time.now - t).round(3)} seconds."
end

.init_with_program(prog) ⇒ Object

Create the Mercenary command for the Jekyll CLI for this Command



6
7
8
9
10
11
12
13
14
15
16
17
18
19
# File 'lib/jekyll/commands/build.rb', line 6

def init_with_program(prog)
  prog.command(:build) do |c|
    c.syntax      'build [options]'
    c.description 'Build your site'
    c.alias :b

    add_build_options(c)

    c.action do |_, options|
      options["serving"] = false
      Jekyll::Commands::Build.process(options)
    end
  end
end

.process(options) ⇒ Object

Build your jekyll site Continuously watch if ‘watch` is set to true in the config.



23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
# File 'lib/jekyll/commands/build.rb', line 23

def process(options)
  # Adjust verbosity quickly
  Jekyll.logger.adjust_verbosity(options)

  options = configuration_from_options(options)
  site = Jekyll::Site.new(options)

  if options.fetch('skip_initial_build', false)
    Jekyll.logger.warn "Build Warning:", "Skipping the initial build. This may result in an out-of-date site."
  else
    build(site, options)
  end

  if options.fetch('detach', false)
    Jekyll.logger.info "Auto-regeneration:", "disabled when running server detached."
  elsif options.fetch('watch', false)
    watch(site, options)
  else
    Jekyll.logger.info "Auto-regeneration:", "disabled. Use --watch to enable."
  end
end

.watch(_site, options) ⇒ Object

Private: Watch for file changes and rebuild the site.

site - A Jekyll::Site instance options - A Hash of options passed to the command

Returns nothing.



70
71
72
73
# File 'lib/jekyll/commands/build.rb', line 70

def watch(_site, options)
  External.require_with_graceful_fail 'jekyll-watch'
  Jekyll::Watcher.watch(options)
end