[jira] [Closed] (FLINK-3975) Override baseurl when serving docs locally

["Ufuk Celebi (JIRA)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/FLINK-3975?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Ufuk Celebi closed FLINK-3975.
------------------------------
       Resolution: Fixed
    Fix Version/s: 1.0.4
                   1.1.0

Fixed in bba82cf (release-1.0), 546b64f (master)

> Override baseurl when serving docs locally
> ------------------------------------------
>
>                 Key: FLINK-3975
>                 URL: https://issues.apache.org/jira/browse/FLINK-3975
>             Project: Flink
>          Issue Type: Bug
>          Components: Documentation
>         Environment: centos 7.2, jekyll 3.1.6, ruby 2.3.1
>            Reporter: Dyana Rose
>            Priority: Trivial
>             Fix For: 1.1.0, 1.0.4
>
>
> when running the documentation build script as:
> {{./build_docs.sh -p}} the docs are built using the correctly overridden baseurl, but they are then served from the wrong url making it a wee bit more difficult than intended to review changes locally.
> The following is the output from running the script:
> {quote}
> Configuration file: _config.yml
> Configuration file: _local_preview_conf.yml
>             Source: /vagrant/flink/docs
>        Destination: /vagrant/flink/docs/target
>  Incremental build: disabled. Enable with --incremental
>       Generating...
> /home/vagrant/.rbenv/versions/2.3.1/lib/ruby/gems/2.3.0/gems/pygments.rb-0.6.3/lib/pygments/popen.rb:57: warning: Insecure world writable dir /opt/scala-2.11.8/bin in PATH, mode 040777
>                     done in 16.736 seconds.
>  Auto-regeneration: enabled for '/vagrant/flink/docs'
> Configuration file: /vagrant/flink/docs/_config.yml
>     Server address: http://0.0.0.0:4000//ci.apache.org/projects/flink/flink-docs-master/
>   Server running... press ctrl-c to stop.
> {quote}
> As you see it looks to be using both config files to build, but only the default config file to serve.
> This can be fixed by just removing the {{_local_preview_conf.yml}} file and instead specify the baseurl as an option to the serve command, so it becomes {{serve --config _config.yml --baseurl= --watch}}. Giving an output of:
> {quote}
> Configuration file: _config.yml
>             Source: /vagrant/flink/docs
>        Destination: /vagrant/flink/docs/target
>  Incremental build: disabled. Enable with --incremental
>       Generating...
> /home/vagrant/.rbenv/versions/2.3.1/lib/ruby/gems/2.3.0/gems/pygments.rb-0.6.3/lib/pygments/popen.rb:57: warning: Insecure world writable dir /opt/scala-2.11.8/bin in PATH, mode 040777
>                     done in 15.928 seconds.
>  Auto-regeneration: enabled for '/vagrant/flink/docs'
> Configuration file: /vagrant/flink/docs/_config.yml
>     Server address: http://0.0.0.0:4000/
>   Server running... press ctrl-c to stop.
> {quote}



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)