Re: [smarthome-dev] ESH Documentation

[Kai Kreuzer <kai@xxxxxxxxxxx>]

Hi Markus,

Yes, the way it should be is:
1. Run „mvn clean install“ in docs
2. Run „jekyll serve“ in docs
3. Access http://localhost:4000 in the browser

Trying it now, I also have the issue that css is not found and links are broken.
This used to work in the past, so we will have to figure out why it isn’t working anymore.
I know that there are issues with newer Jekyll versions - someone told me that it works with an older version, but not anymore with the current one…

Regards,
Kai


> On 04 May 2016, at 09:24, Markus Rathgeb <maggu2810@xxxxxxxxx> wrote:
> 
> Hi again,
> 
> I would like to read / review the documentation in the generated form.
> I switch to change the directory to docs and call "mvn clean install".
> After that I tried to use "jekyll serve" in the docs directory and in
> docs/_site, but this is not working as expected.
> 
> Using docs or docs_site for serve the first page is shown correctly,
> but after a click on documentation the css and js stuff is missing.
> [2016-05-04 09:18:56] ERROR `/documentation/css/styles.css' not found.
> [2016-05-04 09:18:56] ERROR `/documentation/js/init.js' not found.
> So the page is not shown correctly.
> 
> Also, if I press on a link of the documentation, the next site is
> loaded from documentation/documentation instead of documentation.
> 
> e.g. '/documentation/documentation/development/rules/rest-api.html'
> instead of '/documentation/development/rules/rest-api.html'.
> 
> [2016-05-04 09:22:10] ERROR
> `/documentation/documentation/development/rules/rest-api.html' not
> found.
> 
> If somone could tell me what to do, I can perhaps add it to README or
> something similar (I hope there is not already one that I have
> missed).
> 
> Best regards,
> Markus
> 
> 2016-04-15 18:24 GMT+02:00 Kai Kreuzer <kai@xxxxxxxxxxx>:
>> Ok, very cool, thanks for the hint. Now all I need it time :-o
>> 
>> 
>>> On 15 Apr 2016, at 18:20, Benjamin Cabé <benjamin@xxxxxxxxxxx> wrote:
>>> 
>>> It sure can! See e.g https://hudson.eclipse.org/xtext/job/website-deploy/
>>> I think you may want to have a look at https://bugs.eclipse.org/bugs/show_bug.cgi?id=463327. Mikael, cc’d, should also be able to provide more pointers as to whether you can leverage some of the CBI infrastructure for doing that.
>>> 
>>> Benjamin –
>>> 
>>> 
>>> 
>>> 
>>> Le 15/04/2016 18:42, « Kai Kreuzer » <smarthome-dev-bounces@xxxxxxxxxxx au nom de kai@xxxxxxxxxxx> a écrit :
>>> 
>>>> Hi Markus,
>>>> 
>>>> The documentation is updated „from time to time“ by myself through a manual process (building it locally through Jekyll and creating a commit for the git repo of the Eclipse website). I have no idea whether this can be automated somehow…
>>>> 
>>>> Regards,
>>>> Kai
>>>> 
>>>>> On 14 Apr 2016, at 10:21, Markus Rathgeb <maggu2810@xxxxxxxxx> wrote:
>>>>> 
>>>>> Hello,
>>>>> 
>>>>> at which time the Documentation at
>>>>> https://www.eclipse.org/smarthome/documentation/ is updated?
>>>>> Can I trigger an update myself (as I don't know how it is done
>>>>> currently, I cannot check it myself).
>>>>> 
>>>>> Best regards,
>>>>> Markus
>>>>> _______________________________________________
>>>>> smarthome-dev mailing list
>>>>> smarthome-dev@xxxxxxxxxxx
>>>>> To change your delivery options, retrieve your password, or unsubscribe from this list, visit
>>>>> https://dev.eclipse.org/mailman/listinfo/smarthome-dev
>>>> 
>>>> _______________________________________________
>>>> smarthome-dev mailing list
>>>> smarthome-dev@xxxxxxxxxxx
>>>> To change your delivery options, retrieve your password, or unsubscribe from this list, visit
>>>> https://dev.eclipse.org/mailman/listinfo/smarthome-dev
>>> 
>>> _______________________________________________
>>> smarthome-dev mailing list
>>> smarthome-dev@xxxxxxxxxxx
>>> To change your delivery options, retrieve your password, or unsubscribe from this list, visit
>>> https://dev.eclipse.org/mailman/listinfo/smarthome-dev
>> 
>> _______________________________________________
>> smarthome-dev mailing list
>> smarthome-dev@xxxxxxxxxxx
>> To change your delivery options, retrieve your password, or unsubscribe from this list, visit
>> https://dev.eclipse.org/mailman/listinfo/smarthome-dev
> _______________________________________________
> smarthome-dev mailing list
> smarthome-dev@xxxxxxxxxxx
> To change your delivery options, retrieve your password, or unsubscribe from this list, visit
> https://dev.eclipse.org/mailman/listinfo/smarthome-dev