cloudstack-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Sebastien Goasguen <run...@gmail.com>
Subject Re: [DOCS] feedback
Date Mon, 02 Sep 2013 20:37:10 GMT

On Sep 2, 2013, at 4:06 PM, Ian Duffy <ian@ianduffy.ie> wrote:

>> yes please, I had issues with missing fonts...
> 
> First issue was font, I was missing Consolas. Grabbed it from here
> http://www.fontpalace.com/font-details/Consolas/ and just installed using
> the fonts manager in OSX.
> 
> Then I hit an issue with sectsty.sty not being found. Thankfully the tex
> package manager took care of this.
> $ sudo tlmgr update --all
> $ sudo tlmgr install sectsty
> 
> and then same again with paralist.sty
> $ sudo tlmgr install paralist

Ok had to add :

$sudo tlmgr install preprint

the pdf looks clean, simple but clean

thanks

> 
> After that it was building just fine.
> 
> 
> On 2 September 2013 20:56, Sebastien Goasguen <runseb@gmail.com> wrote:
> 
>> 
>> On Sep 2, 2013, at 3:53 PM, Ian Duffy <ian@ianduffy.ie> wrote:
>> 
>>>> By syntax highlighting do you mean marking 'code sections'? If so then
>>> yes you can...
>>> 
>>> http://daringfireball.net/**projects/markdown/syntax#**precode<
>> http://daringfireball.net/projects/markdown/syntax#precode>
>>> 
>>> No, syntax highlighting isn't part of the markdown spec, which is why I
>>> asked. Its something github added to their own flavor of it.
>>> 
>>>> latex on OSX is a bit of a pain, I have an issue with it too, will look
>>> at it in the coming days.
>>> I got around it eventually. If you want me to post details I can go back
>> on
>>> my bash history.
>>> 
>> 
>> yes please, I had issues with missing fonts...
>> 
>>> 
>>> On 2 September 2013 20:46, Sebastien Goasguen <runseb@gmail.com> wrote:
>>> 
>>>> 
>>>> On Sep 2, 2013, at 3:31 PM, Ian Duffy <ian@ianduffy.ie> wrote:
>>>> 
>>>>> Love the idea of using markdown! Much easier to write then docbook.
>>>>> 
>>>>> Any idea if it supports the syntax highlighting markdown features
>> github
>>>>> offer?
>>>>> 
>>>>> e.g.
>>>>> 
>>>>> ```shell
>>>>> #!/bin/bash
>>>>> echo "hello world"
>>>>> ```
>>>>> 
>>>>> Had some slight issues building on OSX due to me missing the font used
>>>> and
>>>>> certain laTeX plugins.
>>>>> I noticed when I built it some of the code didn't wrap correctly and
>> went
>>>>> outside of its codeblock, can
>>>>> this be fixed or is it something we just live with?
>>>>> 
>>>> 
>>>> latex on OSX is a bit of a pain, I have an issue with it too, will look
>> at
>>>> it in the coming days.
>>>> 
>>>> If you open the markdown file in github you will see the rendering right
>>>> there...
>>>> 
>>>>> On 2 September 2013 17:53, sebgoa <runseb@gmail.com> wrote:
>>>>> 
>>>>>> 
>>>>>> On Sep 2, 2013, at 5:19 PM, sebgoa <runseb@gmail.com> wrote:
>>>>>> 
>>>>>>> Hi,
>>>>>>> 
>>>>>>> After seeing lots of frustrated people with folks I decided to
try
>>>>>> something out with markdown.
>>>>>>> 
>>>>>> 
>>>>>> s/folks/docs
>>>>>> 
>>>>>>> I used pandoc to convert some docbook files to markdown and I
used a
>>>>>> structure for a book based on 'The little mongodb' book.
>>>>>>> We can generate epub and pdf using latex.
>>>>>>> 
>>>>>>> See:
>>>>>>> 
>>>>>>> https://github.com/runseb/cloudstack-books
>>>>>>> 
>>>>>>> There are two "books" aimed at being step by step recipes. Not
long,
>>>> not
>>>>>> convoluted, single OS, etc…simple step by step.
>>>>>>> 
>>>>>>> 
>>>>>> 
>>>> 
>> https://github.com/runseb/cloudstack-books/blob/master/en/clients.markdown
>>>>>>> 
>>>>>> 
>>>> 
>> https://github.com/runseb/cloudstack-books/blob/master/en/installation.markdown
>>>>>>> 
>>>>>>> I am still sanitizing the installation one based on 4.2 .
>>>>>>> 
>>>>>>> Comments, flames ?
>>>>>>> 
>>>>>>> -Sebastien
>>>>>>> 
>>>>>> 
>>>>>> 
>>>> 
>>>> 
>> 
>> 


Mime
View raw message