OK, got jekyll working locally. I followed these instructions: https://www.phusionpassenger.com/library/walkthroughs/deploy/ruby/ownserver /standalone/oss/install_language_runtime.html
One of the steps was to install bundler. That might be why you got the .bundle error. You will also need to copy _config.yml to local_config.yml and edit the baseurl to the path to your repo. You will get errors in the console that it can't load the CSS until you get that right. Then I set the current directory to the royale-docs repo and run: jekyll build --config local_config.yml I did this on my Mac. The CI server is running Jekyll on Windows. I followed the steps for installing Jekyll on Cygwin because the CI server is running a version of Windows that may not be supported by Ubuntu on Windows. I followed this post: https://matt.scharley.me/2012/03/windows-cygwin-and-jekyll.html HTH, -Alex On 1/24/18, 3:36 PM, "Alex Harui" <aha...@adobe.com.INVALID> wrote: >I haven't been testing locally. I just push it and build it on the CI >server. > >I will look into building it locally. On the CI server, we are only using >"Jekyll build" and not "Jekyll serve". And you will probably have to use >a custom config file to override the default baseurl. > >Right now, the site is so small that it builds really quickly, so I don't >think I care if you also just push/build/test. Just let us know when you >are in there so we don't make other changes to the files. > >I'll post instructions for local builds once I figure it out. > >-Alex > >On 1/24/18, 2:51 PM, "carlos.rov...@gmail.com on behalf of Carlos Rovira" ><carlos.rov...@gmail.com on behalf of carlosrov...@apache.org> wrote: > >>Thanks Alex, >>I can see it working online :) >>I'm trying to test it localy but don't know how to do it. >>In order to make the html/css looks good, I need to work localy, please >>let >>me know how yo do it >>I installed already ruby, jekyll, etc... and tried to run "bundle exec >>jekyll serve" but we don't have Gem file result is: >> >>Could not locate Gemfile or .bundle/ directory >> >>Maybe there's a more easy way to test this. >> >>Carlos >> >> >>2018-01-19 21:59 GMT+01:00 Alex Harui <aha...@adobe.com.invalid>: >> >>> OK, I got the CSS to load. You can hit this link: >>> >>> >>>https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fapache. >>>g >>>ithub.io%2Froyale-docs%2Ftest%2Ftest.html&data=02%7C01%7Caharui%40adobe. >>>c >>>om%7Cef158780d4714a61dfb908d5637d039e%7Cfa7b1b5a7b34438794aed2c178decee1 >>>% >>>7C0%7C0%7C636524310941764543&sdata=mD2KTprJ9GvEsEjVw1k256pI8yq0BbP%2F%2B >>>o >>>DkQhpAckI%3D&reserved=0 >>> >>> I'm going to look into automatic TOC generation next. IMO, we should >>> decide what kind of header/footer we want not only for the docs on this >>> site, but for ASDoc and Olaf's TryItNow as well and start implementing >>>it. >>> Like this page, it may not look great right away, but we can iterate >>> towards making it look good. >>> >>> My 2 cents, >>> -Alex >>> >>> On 1/19/18, 1:10 AM, "Alex Harui" <aha...@adobe.com.INVALID> wrote: >>> >>> >I'm out of time for today, but I tested templates and jekyll and >>>started >>> >to get something to work. >>> > >>> >https://na01.safelinks.protection.outlook.com/?url= >>> https%3A%2F%2Fapache.gi >>> >thub.io%2Froyale-docs%2Ftest%2Ftest.html&data=02%7C01%7Caharui% >>> 40adobe.com >>> >%7C8d9c2ab112564497fb2608d55f1c7c23%7Cfa7b1b5a7b34438794aed2c178de >>> cee1%7C0 >>> >%7C0%7C636519498299260185&sdata=2egj2BghYos4ur% >>> 2FUSpvN4Vrzh8IOj6rPngvyAJe8 >>> >ZqM%3D&reserved=0 >>> > >>> >You can see the test/test.md and _layouts/docpage.html in the >>>royals-docs >>> >repo. The CSS file didn't load for some reason. Feel free to figure >>>it >>> >out or I will look into it tomorrow. >>> > >>> >HTH, >>> >-Alex >>> > >>> >On 1/18/18, 6:08 PM, "Alex Harui" <aha...@adobe.com.INVALID> wrote: >>> > >>> >>This is for doc, not code so I'm not sure the issue I raised matters. >>> >> >>> >>That said, I've been reading this [1] and it seems like we should be >>>able >>> >>to set up a few templates sort of like we did flex.a.o and not worry >>>so >>> >>much about customizing a third-party theme. >>> >> >>> >>[1] >>> >>https://na01.safelinks.protection.outlook.com/?url= >>> https%3A%2F%2Fjekyllrb >>> >>. >>> >>com%2Fdocs&data=02%7C01%7Caharui%40adobe.com% >>> 7C6fca45a581614f01bbd008d55e >>> >>e >>> >>190da%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0% >>> 7C636519245260410634&sda >>> >>t >>> >>a=SnZeokcfQXRyaHs338A04ENYTLx%2FWSwo42KPSsA3S9k%3D&reserved=0 >>> >> >>> >>On 1/18/18, 5:28 PM, "Piotr Zarzycki" <piotrzarzyck...@gmail.com> >>>wrote: >>> >> >>> >>>Carlos, >>> >>> >>> >>>I like your findings jeckyll theme doc. >>> >>> >>> >>>It looks like we may have again similar issue with license as we >>>have in >>> >>>MDLExample. >>> >>> >>> >>>Can someone raise jira for both cases? Alex raises question on legal >>> >>>couple >>> >>>of days ago. No responses. Let's not wait block us with it - push >>>things >>> >>>forward. Jira could be better to do this. >>> >>> >>> >>>Thanks, >>> >>>Piotr >>> >>> >>> >>>On Fri, Jan 19, 2018, 02:08 Justin Mclean <jus...@classsoftware.com> >>> >>>wrote: >>> >>> >>> >>>> Hi, >>> >>>> >>> >>>> > I think this looks very good and seems to be responsive >>> >>>> > >>> >>>> > >>> >>>>[1]https://na01.safelinks.protection.outlook.com/?url= >>> http%3A%2F%2Fmist >>> >>>>i >>> >>>>c >>> >>>>>>>100.github.io%2Fjekyll-bootstrap-doc&data=02%7C01%7Caharui%40adobe.c >>>>>>>o >>>>>>>m >>> % >>> >>>>7 >>> >>>>C >>> >>>>9c168d0de9074f2fc06108d55edbea4f%7Cfa7b1b5a7b34438794aed2c178de >>> cee1%7C0 >>> >>>>% >>> >>>>7 >>> >>>>C0%7C636519220978547047&sdata=cUfWYBGYEBBEd% >>> 2FpwSfe9bxwJd6N%2BmnyMC0pK% >>> >>>>2 >>> >>>>F >>> >>>>EepY8o%3D&reserved=0 >>> >>>> > [2] >>> >>>>https://na01.safelinks.protection.outlook.com/?url= >>> https%3A%2F%2Fgithub >>> >>>>. >>> >>>>c >>> >>>>om%2Fallejo%2Fjekyll-docs-theme&data=02%7C01%7Caharui%40adobe.com >>> %7C9c1 >>> >>>>6 >>> >>>>8 >>> >>>>d0de9074f2fc06108d55edbea4f%7Cfa7b1b5a7b34438794aed2c178de >>> cee1%7C0%7C0% >>> >>>>7 >>> >>>>C >>> >>>>636519220978547047&sdata=hY3xQXdzTO8RFF7COWVNJtd% >>> 2BzoXqck04VV68TxcIKFs% >>> >>>>3 >>> >>>>D >>> >>>>&reserved=0 >>> >>>> >>> >>>> From a quick look this contains CSS code licensed under CC-BY-3.0 >>> >>>>(looks >>> >>>> like it comes from bootstrap docs). That may or may not be an >>>issue, >>> >>>> depending on the current conversation around this on legal >>>discuss, >>> >>>>and >>> >>>> what you want to do with it. >>> >>>> >>> >>>> Thanks, >>> >>>> Justin >>> >> >>> > >>> >>> >> >> >>-- >>Carlos Rovira >>https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fabout.me% >>2 >>Fcarlosrovira&data=02%7C01%7Caharui%40adobe.com%7Cef158780d4714a61dfb908d >>5 >>637d039e%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636524310941764543& >>s >>data=J7QoUjj3VjvkcYhHaGAdqW3%2B8XU0a2ctG04LorBuYWI%3D&reserved=0 >
