Re: [smarthome-dev] ESH Documentation

[Kai Kreuzer <kai@xxxxxxxxxxx>]

I have to correct myself!
I noticed I had privacy badger activated in my browser and thus is blocked loading the css and other stuff.

So now it is working as described below - the only missing feature are the font icons, but that is imho ok.

If you have problems, I assume it is hence due to the used Jekyll version. Mine is 2.5.3.

Regards,
Kai

> Am 04.05.2016 um 09:31 schrieb 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
> 
> _______________________________________________
> 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