README for bitbucket - export to which format?

README for bitbucket - export to which format?

[Rainer M Krug]

[-- Attachment #1: Type: text/plain, Size: 854 bytes --]

Hi

There are many formats available for READMEs on bitbucket, but
unfortunately not org mode (I am staying on bitbucket for private repos
and move them to github as soon as they can be made public - matter of
finances).

So what is the best export format from org for bitbucket READMEs? At the
moment I am using text (UTF8) Which works, but I would like to have
syntax highlighting and clickable links?

Thanks,

Rainer

-- 
Rainer M. Krug, PhD (Conservation Ecology, SUN), MSc (Conservation Biology, UCT), Dipl. Phys. (Germany)

Centre of Excellence for Invasion Biology
Stellenbosch University
South Africa

Tel :       +33 - (0)9 53 10 27 44
Cell:       +33 - (0)6 85 62 59 98
Fax :       +33 - (0)9 58 10 27 44

Fax (D):    +49 - (0)3 21 21 25 22 44

email:      Rainer@krugs.de

Skype:      RMkrug

PGP: 0x0F52F982

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 454 bytes --]

Re: README for bitbucket - export to which format?

[Jeroen Tiebout]

As far as I know markdown is the de facto standard for readme files on
both GitHub and BitBucket.
Org exporter does a fine job of translating your org file to .md

Hope that helps.

Jeroen

On Friday 2015-12-04 13:38:47 CET, Rainer M Krug <Rainer@krugs.de> wrote:

> Hi
>
> There are many formats available for READMEs on bitbucket, but
> unfortunately not org mode (I am staying on bitbucket for private repos
> and move them to github as soon as they can be made public - matter of
> finances).
>
> So what is the best export format from org for bitbucket READMEs? At the
> moment I am using text (UTF8) Which works, but I would like to have
> syntax highlighting and clickable links?
>
> Thanks,
>
> Rainer

Re: README for bitbucket - export to which format?

[Rainer M Krug]

[-- Attachment #1: Type: text/plain, Size: 1393 bytes --]

Jeroen Tiebout <jeroen@tinktenk.be> writes:

> As far as I know markdown is the de facto standard for readme files on
> both GitHub and BitBucket.
> Org exporter does a fine job of translating your org file to .md

Thanks - I tried it before and it did not work, =but I realized that the
toc was the problem. disabled toc export and it works fine.

Thanks,

Rainer

>
> Hope that helps.
>
> Jeroen
>
> On Friday 2015-12-04 13:38:47 CET, Rainer M Krug <Rainer@krugs.de> wrote:
>
>> Hi
>>
>> There are many formats available for READMEs on bitbucket, but
>> unfortunately not org mode (I am staying on bitbucket for private repos
>> and move them to github as soon as they can be made public - matter of
>> finances).
>>
>> So what is the best export format from org for bitbucket READMEs? At the
>> moment I am using text (UTF8) Which works, but I would like to have
>> syntax highlighting and clickable links?
>>
>> Thanks,
>>
>> Rainer
>

-- 
Rainer M. Krug, PhD (Conservation Ecology, SUN), MSc (Conservation Biology, UCT), Dipl. Phys. (Germany)

Centre of Excellence for Invasion Biology
Stellenbosch University
South Africa

Tel :       +33 - (0)9 53 10 27 44
Cell:       +33 - (0)6 85 62 59 98
Fax :       +33 - (0)9 58 10 27 44

Fax (D):    +49 - (0)3 21 21 25 22 44

email:      Rainer@krugs.de

Skype:      RMkrug

PGP: 0x0F52F982

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 454 bytes --]

Re: README for bitbucket - export to which format?

[Rasmus]

Rainer M Krug <Rainer@krugs.de> writes:

> There are many formats available for READMEs on bitbucket, but
> unfortunately not org mode (I am staying on bitbucket for private repos
> and move them to github as soon as they can be made public - matter of
> finances).

You could try Gitlab.  It supports Org.

> So what is the best export format from org for bitbucket READMEs? At the
> moment I am using text (UTF8) Which works, but I would like to have
> syntax highlighting and clickable links?

Probably Rst or markdown...

Rasmus

-- 
A clever person solves a problem. A wise person avoids it

Re: README for bitbucket - export to which format?

[Rainer M Krug]

[-- Attachment #1: Type: text/plain, Size: 1204 bytes --]

Rasmus <rasmus@gmx.us> writes:

> Rainer M Krug <Rainer@krugs.de> writes:
>
>> There are many formats available for READMEs on bitbucket, but
>> unfortunately not org mode (I am staying on bitbucket for private repos
>> and move them to github as soon as they can be made public - matter of
>> finances).
>
> You could try Gitlab.  It supports Org.

Interesting - looks like a alternative. Are there any other advantages
over BitBucket?

>
>> So what is the best export format from org for bitbucket READMEs? At the
>> moment I am using text (UTF8) Which works, but I would like to have
>> syntax highlighting and clickable links?
>
> Probably Rst or markdown...

I am using markdown - works, although I have to disable the toc.

Thanks,

Rainer
>
> Rasmus

-- 
Rainer M. Krug, PhD (Conservation Ecology, SUN), MSc (Conservation Biology, UCT), Dipl. Phys. (Germany)

Centre of Excellence for Invasion Biology
Stellenbosch University
South Africa

Tel :       +33 - (0)9 53 10 27 44
Cell:       +33 - (0)6 85 62 59 98
Fax :       +33 - (0)9 58 10 27 44

Fax (D):    +49 - (0)3 21 21 25 22 44

email:      Rainer@krugs.de

Skype:      RMkrug

PGP: 0x0F52F982

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 454 bytes --]

Re: README for bitbucket - export to which format?

[Rasmus]

Rainer M Krug <Rainer@krugs.de> writes:

>> You could try Gitlab.  It supports Org.
>
> Interesting - looks like a alternative. Are there any other advantages
> over BitBucket?

- You can share your private repos with as many people you want
- Built in CI including production of artifacts (e.g. produce pdf of commit)
- better web interface.
- git annex support
- you can install it on your own server when you no longer feel
  comfortable with the gitlab.com installation.

Rasmus

-- 
Enough with the bla bla!

Re: README for bitbucket - export to which format?

[Grant Rettke]

On Fri, Dec 4, 2015 at 6:38 AM, Rainer M Krug <Rainer@krugs.de> wrote:

Most Git sites using the Github Flavored Markdown, and there is a
package for that in contrib: =ox-gfm=

http://orgmode.org/cgit.cgi/org-mode.git/plain/contrib/lisp/ox-gfm.el

Re: README for bitbucket - export to which format?

[Rainer M Krug]

[-- Attachment #1: Type: text/plain, Size: 462 bytes --]

Grant Rettke <gcr@wisdomandwonder.com> writes:

> On Fri, Dec 4, 2015 at 6:38 AM, Rainer M Krug <Rainer@krugs.de> wrote:
>
> Most Git sites using the Github Flavored Markdown, and there is a
> package for that in contrib: =ox-gfm=
>
> http://orgmode.org/cgit.cgi/org-mode.git/plain/contrib/lisp/ox-gfm.el

Thanks - good to know, but I decided to move to gitlab.

Cheers,

Rainer
-- 
Rainer M. Krug
email: Rainer<at>krugs<dot>de
PGP: 0x0F52F982

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 454 bytes --]