Re: markdown wiki for compiling documentation

[Renato Pontefice]

Hi Alan,
sorry for the delay, this days are...not equal to other days :-)
I've finaly tried what you wrote me.
I've created a repo on GITHub and then went to the wiki tab. I've started
to write in markdown. I saw that I can see the text well formatted, but I
do not understand how can I made a series of things (paragraph etc...). I
think I will need to go to the GITHub Doc for e doc in various format or
can I do that inside the GITHub web site?

Thanks to all

Renato

2016-01-09 18:15 GMT+01:00 Alan Hogan :

> GitHub wikis are not proper products on their own; rather, if you create a
> new repository, you can enable the wiki "feature" for that repository. (And
> the wiki itself will be made available as a git repository, naturally!)
>
> Alan
>
> > On Jan 6, 2016, at 1:06 PM, renato  wrote:
> >
> > Hi Alan,
> > can you send me some link about GitHub?
> > It sounds me in a right way, but I didn't find anything on the github
> > web site.
> >
> > Renato
> >
> > Il giorno mar, 05/01/2016 alle 18.54 -0800, Alan Hogan ha scritto:
> >> GitHub provides Markdown-powered wikis. (At least, configurably
> >> Markdown-powered.)
> >>
> >> As far as automated conversion into other formats, including .doc
> >> (shudder!), take a look at the much-respected Pandoc project.
> >>
> >> Also, be warned: Github Flavored Markdown (GFM) differs from Gruber's
> >> original Markdown in a number of ways (and even more so when [[wiki
> >> syntax]] is added). You may want to let Github provide the HTML
> >> output,
> >> and pipe *that* into pandoc (modulo additional processing) for the
> >> best
> >> and most reliable results.
> >>
> >> Best of luck with your project!
> >>
> >> Alan Hogan
> >> ___
> >> Markdown-Discuss mailing list
> >> Markdown-Discuss@six.pairlist.net
> >> https://pairlist6.pair.net/mailman/listinfo/markdown-discuss
> > ___
> > Markdown-Discuss mailing list
> > Markdown-Discuss@six.pairlist.net
> > https://pairlist6.pair.net/mailman/listinfo/markdown-discuss
> ___
> Markdown-Discuss mailing list
> Markdown-Discuss@six.pairlist.net
> https://pairlist6.pair.net/mailman/listinfo/markdown-discuss
>
___
Markdown-Discuss mailing list
Markdown-Discuss@six.pairlist.net
https://pairlist6.pair.net/mailman/listinfo/markdown-discuss

Re: markdown wiki for compiling documentation

[renato]

Hi Alan,
can you send me some link about GitHub?
It sounds me in a right way, but I didn't find anything on the github
web site.

Renato

Il giorno mar, 05/01/2016 alle 18.54 -0800, Alan Hogan ha scritto:
> GitHub provides Markdown-powered wikis. (At least, configurably
> Markdown-powered.)
> 
> As far as automated conversion into other formats, including .doc
> (shudder!), take a look at the much-respected Pandoc project. 
> 
> Also, be warned: Github Flavored Markdown (GFM) differs from Gruber's
> original Markdown in a number of ways (and even more so when [[wiki
> syntax]] is added). You may want to let Github provide the HTML
> output,
> and pipe *that* into pandoc (modulo additional processing) for the
> best
> and most reliable results.
> 
> Best of luck with your project!
> 
> Alan Hogan
> ___
> Markdown-Discuss mailing list
> Markdown-Discuss@six.pairlist.net
> https://pairlist6.pair.net/mailman/listinfo/markdown-discuss
___
Markdown-Discuss mailing list
Markdown-Discuss@six.pairlist.net
https://pairlist6.pair.net/mailman/listinfo/markdown-discuss

Re: markdown wiki for compiling documentation

[Alan Hogan]

GitHub wikis are not proper products on their own; rather, if you create a new 
repository, you can enable the wiki "feature" for that repository. (And the 
wiki itself will be made available as a git repository, naturally!)

Alan

> On Jan 6, 2016, at 1:06 PM, renato  wrote:
> 
> Hi Alan,
> can you send me some link about GitHub?
> It sounds me in a right way, but I didn't find anything on the github
> web site.
> 
> Renato
> 
> Il giorno mar, 05/01/2016 alle 18.54 -0800, Alan Hogan ha scritto:
>> GitHub provides Markdown-powered wikis. (At least, configurably
>> Markdown-powered.)
>> 
>> As far as automated conversion into other formats, including .doc
>> (shudder!), take a look at the much-respected Pandoc project. 
>> 
>> Also, be warned: Github Flavored Markdown (GFM) differs from Gruber's
>> original Markdown in a number of ways (and even more so when [[wiki
>> syntax]] is added). You may want to let Github provide the HTML
>> output,
>> and pipe *that* into pandoc (modulo additional processing) for the
>> best
>> and most reliable results.
>> 
>> Best of luck with your project!
>> 
>> Alan Hogan
>> ___
>> Markdown-Discuss mailing list
>> Markdown-Discuss@six.pairlist.net
>> https://pairlist6.pair.net/mailman/listinfo/markdown-discuss
> ___
> Markdown-Discuss mailing list
> Markdown-Discuss@six.pairlist.net
> https://pairlist6.pair.net/mailman/listinfo/markdown-discuss
___
Markdown-Discuss mailing list
Markdown-Discuss@six.pairlist.net
https://pairlist6.pair.net/mailman/listinfo/markdown-discuss

re: markdown wiki for compiling documentation

[bowerbird via Markdown-Discuss]

alan said:
>   take a look at the much-respected Pandoc project. 


good suggestion.


and along those lines, perhaps go all the way, and 
use a wiki app coded by pandoc's john macfarlane.


>   https://github.com/jgm/gitit


a running demo, with a sandbox, is at:


>   http://gitit.johnmacfarlane.net


-bowerbird


___
Markdown-Discuss mailing list
Markdown-Discuss@six.pairlist.net
https://pairlist6.pair.net/mailman/listinfo/markdown-discuss

Re: markdown wiki for compiling documentation

[Mandaris Moore III]

Good morning Renato,

It seems to me that you might be better served by keeping the markdown in some 
kind of source repository and then doing the conversion as needed.

You could set up a folder hierarchy to contain your source separately from the 
output and maybe have a commit hook to do the conversion (maybe).

If you insist on a wiki, I don’t know of any that exports individual pages as 
word documents but I haven’t been looking into something like that in a while.

> On Jan 5, 2016, at 3:08 AM, Renato Pontefice  
> wrote:
> 
> Hi,
> I'm very new to this group.
> I've just learned what markdow is and ho it works.
> I need a way, to produce some docs. I need a collaborative ( wiki?) repo, 
> accessible for more people with ACL right.
> I also need to export the doc on various format (pdf, doc, HTML...).
> Could it be the right way?
> 
> TIA
> Renato
> ___
> Markdown-Discuss mailing list
> Markdown-Discuss@six.pairlist.net
> https://pairlist6.pair.net/mailman/listinfo/markdown-discuss



signature.asc
Description: Message signed with OpenPGP using GPGMail
___
Markdown-Discuss mailing list
Markdown-Discuss@six.pairlist.net
https://pairlist6.pair.net/mailman/listinfo/markdown-discuss