Class: Jekyll::Commands::Serve

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

Class Method Summary collapse

Methods inherited from Jekyll::Command

add_build_options, configuration_from_options, inherited, process_site, subclasses

Class Method Details

.file_handler_options ⇒ Object

recreate NondisclosureName under utf-8 circumstance



125
126
127
128
129
130
 
# File 'lib/jekyll/commands/serve.rb', line 125

def file_handler_options
  WEBrick::Config::FileHandler.merge({
    :FancyIndexing     => true,
    :NondisclosureName => ['.ht*','~*']
  })
end

.init_with_program(prog) ⇒ Object 



8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
 
# File 'lib/jekyll/commands/serve.rb', line 8

def init_with_program(prog)
  prog.command(:serve) do |c|
    c.syntax 'serve [options]'
    c.description 'Serve your site locally'
    c.alias :server
    c.alias :s

    add_build_options(c)

    c.option 'detach', '-B', '--detach', 'Run the server in the background (detach)'
    c.option 'port', '-P', '--port [PORT]', 'Port to listen on'
    c.option 'host', '-H', '--host [HOST]', 'Host to bind to'
    c.option 'baseurl', '-b', '--baseurl [URL]', 'Base URL'
    c.option 'skip_initial_build', '--skip-initial-build', 'Skips the initial site build which occurs before the server is started.'

    c.action do |args, options|
      options["serving"] = true
      options["watch"] = true unless options.key?("watch")
      Jekyll::Commands::Build.process(options)
      Jekyll::Commands::Serve.process(options)
    end
  end
end

.mime_types ⇒ Object 



108
109
110
111
 
# File 'lib/jekyll/commands/serve.rb', line 108

def mime_types
  mime_types_file = File.expand_path('../mime.types', File.dirname(__FILE__))
  WEBrick::HTTPUtils::load_mime_types(mime_types_file)
end

.process(options) ⇒ Object

Boot up a WEBrick server which points to the compiled site’s root.



33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
 
# File 'lib/jekyll/commands/serve.rb', line 33

def process(options)
  options = configuration_from_options(options)
  destination = options['destination']
  setup(destination)

  s = WEBrick::HTTPServer.new(webrick_options(options))
  s.unmount("")

  s.mount(
    options['baseurl'],
    WEBrick::HTTPServlet::FileHandler,
    destination,
    file_handler_options
  )

  Jekyll.logger.info "Server address:", server_address(s, options)

  if options['detach'] # detach the server
    pid = Process.fork { s.start }
    Process.detach(pid)
    Jekyll.logger.info "Server detached with pid '#{pid}'.", "Run `kill -9 #{pid}' to stop the server."
  else # create a new server thread, then join it with current terminal
    t = Thread.new { s.start }
    trap("INT") { s.shutdown }
    t.join
  end
end

.server_address(server, options) ⇒ Object 



113
114
115
116
117
118
119
120
121
122
 
# File 'lib/jekyll/commands/serve.rb', line 113

def server_address(server, options)
  baseurl = "#{options['baseurl']}/" if options['baseurl']
  [
    "http://",
    server.config[:BindAddress],
    ":",
    server.config[:Port],
    baseurl || ""
  ].map(&:to_s).join("")
end

.setup(destination) ⇒ Object 



61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
 
# File 'lib/jekyll/commands/serve.rb', line 61

def setup(destination)
  require 'webrick'

  FileUtils.mkdir_p(destination)

  # monkey patch WEBrick using custom 404 page (/404.html)
  if File.exist?(File.join(destination, '404.html'))
    WEBrick::HTTPResponse.class_eval do
      def create_error_page
        @header['content-type'] = "text/html; charset=UTF-8"
        @body = IO.read(File.join(@config[:DocumentRoot], '404.html'))
      end
    end
  end
end

.start_callback(detached) ⇒ Object 



102
103
104
105
106
 
# File 'lib/jekyll/commands/serve.rb', line 102

def start_callback(detached)
  unless detached
    Proc.new { Jekyll.logger.info "Server running...", "press ctrl-c to stop." }
  end
end

.webrick_options(config) ⇒ Object 



77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
 
# File 'lib/jekyll/commands/serve.rb', line 77

def webrick_options(config)
  opts = {
    :BindAddress        => config['host'],
    :DirectoryIndex     => %w(index.html index.htm index.cgi index.rhtml index.xml),
    :DocumentRoot       => config['destination'],
    :DoNotReverseLookup => true,
    :MimeTypes          => mime_types,
    :Port               => config['port'],
    :StartCallback      => start_callback(config['detach'])
  }

  if config['verbose']
    opts.merge!({
      :Logger => WEBrick::Log.new($stdout, WEBrick::Log::DEBUG)
    })
  else
    opts.merge!({
      :AccessLog => [],
      :Logger => WEBrick::Log.new([], WEBrick::Log::WARN)
    })
  end

  opts
end