You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@mynewt.apache.org by aditi hilbert <ad...@runtime.io> on 2015/10/29 08:40:10 UTC

Presenting mynewt documentation on ASF website

Hi all,

I have linked most of the available project documentation off “Documentation” in the navigation bar of the fledgling Mynewt website on ASF. I am using Mkdocs to render the html from markdown but it appears to have some issues e.g. with anchors. Does anyone have any other suggestions for building html docs from markdown?

Sorry for the spam of commit notifications in Will’s name (wes3) earlier while I tried to get this up. My account is still not accessible to me but Geoffrey from the ASF infrastructure team is working on it.

thanks,
aditi

Re: Presenting mynewt documentation on ASF website

Posted by aditi hilbert <ad...@runtime.io>.
Hi Taylor,

Thanks for the suggestion - I’ll look into it. 
I was able to resolve the anchor issue in mkdocs, so for now we are ok :)

thanks,
aditi


> On Oct 29, 2015, at 11:28 AM, P. Taylor Goetz <pt...@gmail.com> wrote:
> 
> Hi Aditi,
> 
> For the Storm website, we use Jekyll [1].
> 
> It’s not perfect, but it’s flexible to do pretty much whatever you need.
> 
> -Taylor
> 
> [1] http://jekyllrb.com <http://jekyllrb.com/>
> 
> 
>> On Oct 29, 2015, at 3:40 AM, aditi hilbert <aditi@runtime.io <ma...@runtime.io>> wrote:
>> 
>> Hi all,
>> 
>> I have linked most of the available project documentation off “Documentation” in the navigation bar of the fledgling Mynewt website on ASF. I am using Mkdocs to render the html from markdown but it appears to have some issues e.g. with anchors. Does anyone have any other suggestions for building html docs from markdown?
>> 
>> Sorry for the spam of commit notifications in Will’s name (wes3) earlier while I tried to get this up. My account is still not accessible to me but Geoffrey from the ASF infrastructure team is working on it.
>> 
>> thanks,
>> aditi
>

Re: Presenting mynewt documentation on ASF website

Posted by "P. Taylor Goetz" <pt...@gmail.com>.
Hi Aditi,

For the Storm website, we use Jekyll [1].

It’s not perfect, but it’s flexible to do pretty much whatever you need.

-Taylor

[1] http://jekyllrb.com <http://jekyllrb.com/>


> On Oct 29, 2015, at 3:40 AM, aditi hilbert <ad...@runtime.io> wrote:
> 
> Hi all,
> 
> I have linked most of the available project documentation off “Documentation” in the navigation bar of the fledgling Mynewt website on ASF. I am using Mkdocs to render the html from markdown but it appears to have some issues e.g. with anchors. Does anyone have any other suggestions for building html docs from markdown?
> 
> Sorry for the spam of commit notifications in Will’s name (wes3) earlier while I tried to get this up. My account is still not accessible to me but Geoffrey from the ASF infrastructure team is working on it.
> 
> thanks,
> aditi