python-markdown-discuss

[Python-markdown-discuss] Announcing Apydia

[Waylan L. <wa...@gm...>]

Earlier today Apydia was released to the world. Apydia is an API
reference documentation generator for Python that **supports
markdown** (among others) in doc strings.

Needless to say, I'm pretty excited about this even if I had nothing
to do with it. I've already added it to the "related projects" page on
the site. Below is a copy of the full announcement.


---------- Forwarded message ----------
From: Daniel Haus <dan...@gm...>
Date: Nov 30, 2007 5:51 AM
Subject: [elixir] Announcing Apydia
To: SQLElixir <sql...@go...>



Today, I am very excited to announce the first release of the Apydia
API reference documentation generator for Python. It's designed as an
instantly serviceable replacement for Pudge's API documentation
generator. It won't generate complete websites from reST etc. like
Pudge does, though - Apydia is only about the API.

Features include:

- Basic Pudge compatibility and a short and easy migration path
- Rudimentary Trac-integration, that is links into Trac's sourcecode
browser
- Some fair amount of usability
- Setuptools integration
- Flexible, Genshi/XInclude-based themeability with theme inheritance
- Support for various text formats like Markdown, Textile and reST
- Other parsers can easily be plugged in on demand
- Syntax highlighting thanks to Pygments

For more information visit Apydia's web site at http://apydia.ematia.de
and the Apydia Google Group at http://groups.google.com/group/apydia.

--
Daniel Haus
http://ematia.de
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google
Groups "SQLElixir" group.
To post to this group, send email to sql...@go...
To unsubscribe from this group, send email to
sql...@go...
For more options, visit this group at
http://groups.google.com/group/sqlelixir?hl=en
-~----------~----~----~----~------~----~------~--~---




-- 
----
Waylan Limberg
wa...@gm...

Re: [Python-markdown-discuss] Announcing Apydia

[Waylan L. <wa...@gm...>]

FYI, here's my response as posted on the Apydia list:

On Nov 30, 2007 1:26 PM, Waylan Limberg <wa...@gm...> wrote:
> First, as one of the core markdown devs, I'd like to say that I'm
> excited to see support for markdown. That has been an itch I've wanted
> scratched for some time.
>
> To add to that, I see you are also using a stripped down version of my
> CodeHilite extension for markdown. That's excellent! I've been
> debating weather I should do the same to the extension. I first
> started that extension before Pygments (even before there was an
> extension api for markdown), so all the non-pygments stuff came first.
> When I first discovered pygments, I just added it into the existing
> api. Now I don't see any need for the other stuff.
>
> Anyway, I have never received any feedback on the syntax for
> specifying the language used on code blocks. As there is no
> established convention in markdown in general, I came up with my own.
> So, yeah, you probably should document it. Of course, I'm open to
> other/better suggestions.


-- 
----
Waylan Limberg
wa...@gm...