cloudstack-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ian Duffy <...@ianduffy.ie>
Subject Re: [DOCS] feedback
Date Mon, 02 Sep 2013 20:06:56 GMT
> 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

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
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message