contrib: cheatsheet

View: New views
5 Messages — Rating Filter:   Alert me  

contrib: cheatsheet

by Alex Efros-4 :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

Hi!

I've just finished my cheatsheet for AsciiDoc. It designed to be both very
comprehensive and ease to use: http://powerman.name/doc/asciidoc

P.S. Actually, it looks like there nobody in this maillist except me... :)

--
                        WBR, Alex.
_______________________________________________
asciidoc-discuss mailing list
asciidoc-discuss@...
http://lists.metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss

Re: contrib: cheatsheet

by Maciej BliziƄski-5 :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

Looks can be deceiving. ;-)

Well done!

I like the example what a comment looks like after compilation. ;-)

Maciej

2008/4/12, Alex Efros <powerman@...>:

> Hi!
>
>  I've just finished my cheatsheet for AsciiDoc. It designed to be both very
>  comprehensive and ease to use: http://powerman.name/doc/asciidoc
>
>  P.S. Actually, it looks like there nobody in this maillist except me... :)
>
>
>  --
>                         WBR, Alex.
>  _______________________________________________
>  asciidoc-discuss mailing list
>  asciidoc-discuss@...
>  http://lists.metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss
>
_______________________________________________
asciidoc-discuss mailing list
asciidoc-discuss@...
http://lists.metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss

Re: contrib: cheatsheet

by Stuart Rackham :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

That's very nice Alex, I really like the side-by-side presentation. Are
you able to post the AsciiDoc source? I would be handy for people to see
how you've done it in AsciiDoc. I'll put put a link to the cheatsheet on
the AsciiDoc webpage when I next update the website -- or if you prefer
I could include the cheatsheet in the AsciiDoc distribution docs.

Cheers, Stuart


Alex Efros wrote:
> Hi!
>
> I've just finished my cheatsheet for AsciiDoc. It designed to be both very
> comprehensive and ease to use: http://powerman.name/doc/asciidoc
>
> P.S. Actually, it looks like there nobody in this maillist except me... :)
>
_______________________________________________
asciidoc-discuss mailing list
asciidoc-discuss@...
http://lists.metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss

Re: contrib: cheatsheet

by Alex Efros-4 :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

Hi!

On Sun, Apr 13, 2008 at 01:26:08PM +1200, Stuart Rackham wrote:
> That's very nice Alex, I really like the side-by-side presentation. Are
> you able to post the AsciiDoc source? I would be handy for people to see
> how you've done it in AsciiDoc. I'll put put a link to the cheatsheet on

Actually, I'm cheating there. :) It's not pure AsciiDoc, I have to use
some html markup in passthrough blocks. Also I hate to write manually
things which may (and should) be generated automatically, so I've a script
which do most of work. It's flexible and simple enough to make very ease
to add new examples and chapters.

I've uploaded sources to http://powerman.name/download/asciidoc/cheatsheet/
You'll find there:
    asciidoc.txt - source of main AsciiDoc-formatted file
    asciidoc_*.txt - auto-generated files included in main file
    asciidoc.d/regen - perl script which generate ../asciidoc_*.txt
    asciidoc.d/*/*.txt - examples for cheatsheet, one example per file

Also you'll notice I've used jQuery library in asciidoc.txt. It used to
remove annoying "Level 1" & "Level 2" entries (used in my examples)
from TOC auto-generated by your toc.js.

> the AsciiDoc webpage when I next update the website -- or if you prefer
> I could include the cheatsheet in the AsciiDoc distribution docs.

Usually I put all such things in Public Domain, so you free to do what you
wish. (BTW, is it possible to add 'license' notice in article header just
like author/version/date?)

--
                        WBR, Alex.
_______________________________________________
asciidoc-discuss mailing list
asciidoc-discuss@...
http://lists.metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss

Re: contrib: cheatsheet

by Stuart Rackham :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

Hi Alex

Alex Efros wrote:

> Hi!
>
> On Sun, Apr 13, 2008 at 01:26:08PM +1200, Stuart Rackham wrote:
>> That's very nice Alex, I really like the side-by-side presentation. Are
>> you able to post the AsciiDoc source? I would be handy for people to see
>> how you've done it in AsciiDoc. I'll put put a link to the cheatsheet on
>
> Actually, I'm cheating there. :) It's not pure AsciiDoc, I have to use
> some html markup in passthrough blocks. Also I hate to write manually
> things which may (and should) be generated automatically, so I've a script
> which do most of work. It's flexible and simple enough to make very ease
> to add new examples and chapters.
>
> I've uploaded sources to http://powerman.name/download/asciidoc/cheatsheet/
> You'll find there:
>     asciidoc.txt - source of main AsciiDoc-formatted file
>     asciidoc_*.txt - auto-generated files included in main file
>     asciidoc.d/regen - perl script which generate ../asciidoc_*.txt
>     asciidoc.d/*/*.txt - examples for cheatsheet, one example per file
>
> Also you'll notice I've used jQuery library in asciidoc.txt. It used to
> remove annoying "Level 1" & "Level 2" entries (used in my examples)
> from TOC auto-generated by your toc.js.

That's very clever, I was wondering how you did it.


>
>> the AsciiDoc webpage when I next update the website -- or if you prefer
>> I could include the cheatsheet in the AsciiDoc distribution docs.
>
> Usually I put all such things in Public Domain, so you free to do what you
> wish. (BTW, is it possible to add 'license' notice in article header just
> like author/version/date?)
>

My preference is to leave it with you. I've added a 'Cheatsheet' link to
the cheatsheet on your site in the AsciiDoc website sidebar menu and
listed it in the 'Resources' on the home page. You might like to
consider adding a footnote explaining how the document was generated.

Thanks for the nice work.


Cheers, Stuart
_______________________________________________
asciidoc-discuss mailing list
asciidoc-discuss@...
http://lists.metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss