Re: Splittling into chapters?

I pull requested a script called "chapterizer" that does exactly that, it divides the text in chapters by title and parse all links, the general case I solve it with a variable that counts by chapter. 2014-07-31 23:14 GMT-03:00 Stas Malyshev <smalyshev@sugarcrm.com>: > Hi! > > > Very nice! I think this split is the overall right strategy for sanity > > of future changes, etc. > > I've found a wrinkle in this script though... If we have a number of > topics with the same name ("General" seems to be most popular) then when > we use big file, the topic Postfix Operators/General is labelled as > "general-13", but in file 10-expressions.md it's now "general-3", > since > it that particular file there's only three links named "General". This > requires renaming all the anchors with repeated names. Which can be > done, but then this no longer can be merged back into the single file, > at least not easily. I'll fix the script and update the pull in a bit. > Since the anchor names are generated automatically and AFAIK there's no > way to override them, the only way to avoid it would be not using the > same names, but that's hard to do. > > > One thing I will advise is that since we have links all over the place > > pointing to the current all-in-one spec php-spec-draft.md, we should > > either have a redirect from it to the table of contents > > (00-specification-for-php.md) or just copy the table of contents > directly > > into that file. Because I think we should remove the big blob and have > > people directed to the table of contents, if we are going this route. > > I think we can put the copy of 00-specification-for-php.md when ready. > -- > Stanislav Malyshev, Software Architect > SugarCRM: http://www.sugarcrm.com/ > > -- > PHP Naming Standardization Mailing List (http://www.php.net/) > To unsubscribe, visit: http://www.php.net/unsub.php > >