This page lists recent changes to the site structure. We're closing in on a stable structure, but until stability is reached, this page should help provide an overview of what's going on.
Note that this page doesn't list all recently changed topics. For that list, see
WebChanges.
- The Perl version used on the server was upgraded from 5.8.4 to 5.8.8. Some changes to the Apache mod_perl configuration were required. There should be no visible functionality changes.
- Converted WebProgramming? to WebChapter using new structure.
- Rationalized the chapter Admin topic handling, they're now called Comment topics, with a TopicType of Comment. See naming conventions in June 11 entry below. ChapterStructure provides technical details about this.
Standardised naming convention for Chapters and Sections. Given a topic Xxx, the pages are
XxxChapter?,
XxxRecipes?,
XxxIntroduction?,
XxxReference?,
XxxOther?,
XxxChapterComments?. Note there are no plurals in titles, except for
XxxRecipes? and
XxxChapterComments?. Changed:
The Cookbook now supports shortcut URLs, like
http://schemewiki.org/Cookbook/RecentSiteChanges.
Conversion of chapters to conform to new
CookbookStructure has begun. This involves changing chapter names from e.g.
StringRecipes to
StringChapter, and the recipe list from e.g.
StringRecipesSection? to
StringRecipes. So far have converted:
- Pressing Cancel on the login dialog will now bring up a page with a link to the registration page.
- Deleted CommonIdiomRecipes, which was redundant.
Continued conversion of chapters. The following chapters have been converted:
Conversion of chapters to conform to
CookbookStructure has begun. Chapters converted so far are listed below, along with the
ParentTopic name which should be used for new recipes added to any of these chapters.
If you're adding new recipes to any of these chapters, you'll need to set the
ParentTopic for the new recipe to the corresponding name in parentheses above. That will automatically add the new recipe to the chapter and to any and all
TOCs, such as
TOC and
SectionIndex.
A number of changes have been made, listed below. This should not currently affect adding or editing of recipes - simply add and edit recipes as usual. One exception is that if you add any new String Recipes or Number Recipes, it is no longer necessary to add an entry for those recipes to the corresponding chapter, since those chapters are now autogenerated. In addition, the
ParentTopic for new recipes in these chapters should be set to
StringRecipes and
NumberRecipeSection? respectively. See below for more info.
- The TOC is now automatically generated, so it is no longer necessary to manually add new chapters to it.
- A new TOC feature has been added, which supports listing of individual recipes, in addition to major section headings. There's a link on the TOC page to access this. This only works for some chapters at the moment, since changes are still underway, as described in CookbookStructure.
The
CookbookForm has been changed to include a
TopicOrder field. This will support ordering of cookbook topics, including chapters, sections, and recipes. This is used in the automatic generation of topics like
TOC,
SectionIndex, and now chapters. The data from the previous NextTopic field has been retained, and will be converted (some of it has already been converted.)
As described above, the
TOC is now automated. In addition, chapters are being similarly automated so that it will no longer be necessary to manually edit chapters to add recipes to them. These changes are described in
CookbookStructure, and have so far been implemented for two chapters,
StringChapter and
NumberRecipes.
--
AntonVanStraaten - 01 Jun 2004