flink-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ufuk Celebi <...@apache.org>
Subject Re: baseurl not overridden in documentation's Jekyll serve for local previewing
Date Wed, 01 Jun 2016 09:08:19 GMT
Hey Tzu-Li! Which commit are you referring to exactly? We just changed
something yesterday and the build docs command now makes sure to use a
specific Jekyll version via Rubygems. The Jekyll version we use is
2.5.3. And with this it works as expected for me.

Previously, we had issues with different Jekyll versions. This might
be what's happening to you and that's why we went with this approach
now. The command we use is `jekyll serve --watch --baseurl=`, which
parses the default _config.yml.

– Ufuk


On Wed, Jun 1, 2016 at 11:00 AM, Tzu-Li (Gordon) Tai <tzulitai@gmail.com> wrote:
> Hi all,
>
> Small problem here regarding locally previewing documentation using Jekyll
> serve.
>
> When the -p flag is used on docs/build_docs.sh for a local server to preview
> documentation, the intended behaviour of Jekyll is to override the baseurl
> setting in the main config docs/_config.yml with an empty value, defined in
> a secondary config docs/_local_preview_conf.yml.
>
> However, this seems to not be working. From the output of docs/build_docs.sh
> it seems like that during the build docs phase of Jekyll, both configuration
> files were read, but for the serve phase only the main _config.yml was read,
> thus not correctly overriding the baseurl for local previewing.
>
> After changing the jekyll command in docs/build_docs.sh to do:
> jekyll serve --config _config.yml --watch --baseurl=
> instead of overriding settings using cascaded config files, then it works
> correctly.
>
> Just want to check whether or not this might be an issue with my environment
> (Jekyll version 3.1.6), or is actually a bug. I couldn't find relevant
> Jekyll issues on the problem on the web.
>
> Thanks,
> Gordon
>
>
>
> --
> View this message in context: http://apache-flink-mailing-list-archive.1008284.n3.nabble.com/baseurl-not-overridden-in-documentation-s-Jekyll-serve-for-local-previewing-tp11938.html
> Sent from the Apache Flink Mailing List archive. mailing list archive at Nabble.com.

Mime
View raw message