Re: User-contributed recipes/documentation

On Thu, May 28, 2009 at 04:02:05PM -0700, R. Tyler Ballance wrote:
> Over the weekend I started working on writing some Cheetah documentation
> in Cheetah and I suppose I should at least share my work (thus far).

I started playing with Sphinx today (http://sphinx.pocoo.org/) and I
think I might just move everything over into Sphinx land. 

I'm hoping to recreate the user's guide and get more comprehensive, and
alive, documentation going with Sphinx (which primarily uses
reStructured text, similar to Markdown). 

The little bit of code I toyed around with for the "current" recipes
stuff linked in the parent post was fun, but unfortunately the macro
support in Cheetah I don't think is good enough for me to use Cheetah to
document itself.

Tavis and I will likely be working together more in the near future on
merging communitycheetah.org and cheetahtemplate.org together so Sphinx
will suit the new set up much better IMHO.

Just letting you folks know :)

> 
> These 'recipes' are written in Markdown, a very writer-friendly format 
> 	(http://daringfireball.net/projects/markdown/basics)
> and are stored inside the source repository to maintain history (I could
> not find a suitable wiki system that could store history inside of Git
> to keep things centralized).
> 
> 
> The recipes you can find are here: http://communitycheetah.org/recipes/ 
> 
> That list is autogenerated from the markdown documents in the
> "recipes/content/" folder: 
> 	http://github.com/rtyler/cheetah/tree/3cd30c6ee108729d880be89f9dcda2b71313f44e/recipes/content
> 
> I'll ping the list when I finish up the two documents I'm currently
> working on, and when I finish a meta-recipe on how to write recipes :)
> 
> 
> If you have any recipes of your own, feel free to fork and commit, or
> throw it up somewhere (pastebin, etc) and ping me and I'll add it to the
> repo.
> 
> 
> Cheers
> -- 
> -R. Tyler Ballance
> Slide, Inc.



> ------------------------------------------------------------------------------
> Register Now for Creativity and Technology (CaT), June 3rd, NYC. CaT 
> is a gathering of tech-side developers & brand creativity professionals. Meet
> the minds behind Google Creative Lab, Visual Complexity, Processing, & 
> iPhoneDevCamp as they present alongside digital heavyweights like Barbarian 
> Group, R/GA, & Big Spaceship. http://p.sf.net/sfu/creativitycat-com 
> _______________________________________________
> Cheetahtemplate-discuss mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/cheetahtemplate-discuss


-- 
-R. Tyler Ballance
Slide, Inc.

------------------------------------------------------------------------------
Register Now for Creativity and Technology (CaT), June 3rd, NYC. CaT 
is a gathering of tech-side developers & brand creativity professionals. Meet
the minds behind Google Creative Lab, Visual Complexity, Processing, & 
iPhoneDevCamp as they present alongside digital heavyweights like Barbarian 
Group, R/GA, & Big Spaceship. http://p.sf.net/sfu/creativitycat-com

_______________________________________________
Cheetahtemplate-discuss mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/cheetahtemplate-discuss

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.9 (GNU/Linux)

iEYEARECAAYFAkojaTIACgkQFCbH3D9R4W8+6ACcDriwLnhHYmVgI4KVWYefqKaS
TPkAoJyp83e8mbPuKzU0qBFKA4Cvg7J1
=12vd
-----END PGP SIGNATURE-----