Hello Yang: Thanks a lot for the introduction. Diving in the best approach. I guess I have to learn Python after all :)
Anmar Yang wrote: > Hey Anmar, > > Stuart may have something more to say, but there isn't (and probably > won't be in the near future) any resource for introducing developers > to the code base (which to be fair is not that large, but I'd say is > not exactly the best Python code I've seen - no offense to Stuart, who > I'm sure whipped it up in a hurry and has much better things to work > on). The question I asked and his reply: > >>> - Developers' documentation, to make it easier for others to >>> understand (from a big-picture perspective) how the code is >>> organized, such that we might be able to contribute more efficiently >>> to the project. >> AsciiDoc is a small fairly straight-forward program (just a 4000 line >> Python script), and while I agree that a nice overview will, well, give >> you nice overview and maybe a leg up the learning curve, if you want to >> modify the source code there's no substitute for a working knowledge of >> the application and just reading the source code. While I've found that >> it's always a psychological hurdle to open up someone else source, you >> very quickly get a much better understanding of how things are put together. > > But perhaps for a specific question (e.g. table-related code) he can > offer a pointer. > > Yang > > > On 11/17/06, Anmar Oueja anmar-at-canada.com |asciidoc| > <...> wrote: >> Hello Stuart: >> >> I have been giving this a lot of thought. I went through many Wiki's >> implementations of Tables (not code, just markup) and found a few good ones. >> >> - Mediawiki has the most flexible and most suitable for multiple lines >> within a table >> - Dokuwiki has a simple but effective formatting >> >> I am willing to look into the code my self, although I am not a >> developer. Do you know where can I get started? >> >> Cheers! >> >> Anmar >> >> Stuart Rackham wrote: >>> Hi Anmar >>> >>> Anmar Oueja wrote: >>>> Hello Stuart: >>>> >>>> Thanks for the quick response. Any chance this will be rectified in >>>> the near future? >>> No this is not a priority for me at this stage -- but I'm happy to look >>> at any workable patches user come up with. >>> >>> From the AsciiDoc User Guide: "The current table syntax is overly >>> complicated and unwieldy to edit, hopefully a more usable syntax will >>> appear in future versions of AsciiDoc." >>> >>> >>> >>> >>>> Anmar >>>> >>>> Stuart Rackham wrote: >>>>> Hi Anmar >>>>> >>>>> The current version only allows a paragraph of text in each cell. >>>>> >>>>> Cheers, Stuart >>>> _______________________________________________ >>>> Asciidoc-discuss mailing list >>>> Asciidoc-discuss@metaperl.com >>>> http://metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss >>>> >>> Cheers, Stuart >> >> _______________________________________________ >> Asciidoc-discuss mailing list >> Asciidoc-discuss@metaperl.com >> http://metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss >> > > _______________________________________________ > Asciidoc-discuss mailing list > Asciidoc-discuss@metaperl.com > http://metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss _______________________________________________ Asciidoc-discuss mailing list Asciidoc-discuss@metaperl.com http://metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss