Textpattern CMS support forum
You are not logged in. Register | Login | Help
- Topics: Active | Unanswered
[wiki] Call for suggestions for refined/improved page/topic titles in TxB
Consider this thread a call for picking whatever TextBook topic title you want and offering a clearer, more meaningful, and shorter suggestion.
Mary brought up a good point about current and new titles in TextBook. Since we’re going to be making presentation changes soon, we should consider the current topic titles ASAP. Her lean was for titles that are clear and meaningful (always a good thing). I’ve been thinking about this too with respect to the new main page layout (please keep layout discussion in that thread, thanks). On the main page, topic information will be presented in three lists under each main section. Since we will have considerably less first-line space for topic titles, it would be strategic to think of clear, meaningful titles that were also shorter.
Note: Changing page titles in TxB does not break links (if done properly), it simply creates a wiki redirect. Over time, we can update forum links when redirects are encountered and nobody will be the wiser; just help update links in your own respective posts and it will all be relatively transparent.
Please visit the TextBook main page, look at all the links in the Table of Contents (ignore chapter title pages, those will be tucked away quietly and out of site), and offer any suggestions you think might be worthwhile for change. I’ll filter this thread and keep a list of changed titles below as they are realized.
I will proffer this bit of thinking: Wherever it is easy to drop the word “Textpattern” in a page title, it might be dropped. I think that is a word that perhaps states the too obvious.
OK, we all know titles are important. Now is your chance to contribute to TextBook without working in the wiki! ;)
EDIT: While you are at it…how about pointing out any pages you think are dead, obsolete, or pointless as well. We will be removing these and starting anew with clear focus on the main page.
Offline
#2 2005-11-19 02:55:13
- Mary
- Sock Enthusiast
- Registered: 2004-06-27
- Posts: 6,236
Re: [wiki] Call for suggestions for refined/improved page/topic titles in TxB
Hopefully this will help kick-start things. :)
- Chapter 1:
TextpatternOrientation - 1.1)
TextpatternLicensing - 1.2)
TextpatternCapabilities and Features - 1.3)
TextpasdcsdfctternSemantic Model - Chapter 2:
Textpattern Acquisition and InstallationSetup and Install (don’t know, but this should use smaller words) - Chapter 4: Common Web Site Setups
with Textpattern - 4.1) Framework for a
TextpatternSite Design - 4.2.4) Custom Article Output with
TextpatternCategories - 4.3.1) Adding Plugins to Your
TextpatternInstallation - 6.2) Renaming the
TextpatternAdmin Directory for Added Security - 6.3.2) Resetting
a TextpatternAdmin Password in the MySQL Database - 6.4) Moving
TextpatternInstallations - 6.5.1) Importing Article Content from One
TextpatternInstall to Another - 6.5.2) Creating Multiple Subdomain Weblogs with One
TextpatternInstall - 7.1) Using Subversion (SVN)
with a Textpattern Site - 7.3) Managing 404 Errors
in a Textpattern Site - 7.4) Troubleshooting Common XHTML Validation Issues
in a Textpattern Site - Appendix A:
TextpatternTag Index - Appendix B:
TextpatternPlugin Availability - Appendix C: Migrating
to Textpatternfrom Another System - Appendix D:
TextpatternResources Listing
Offline
Re: [wiki] Call for suggestions for refined/improved page/topic titles in TxB
Excellent example of what I was referring to, mary. Doesn’t do anything to hurt the meaning.
Now, if we can whittle down the titles in Chapter 6 and 7 a bit better, I think we’re almost home. Those two chapter are obviously going to be put into the “Intermediate/Advanced” main page section, and they even have subcateogorization started which could be used to create nice subcategorization lists (a concept davidwang alluded to), but they currently have page titles are a bit long, and in some cases (chapter 7) are perhaps missing key words. Hence, some of those need shortened, but altered as well.
- 6.1 Unicode Support (UTF-8)
- 6.2 Renaming
the TextpatternAdmin Directory for Added Security - 6.3 User Accounts
- 6.3.1 Modifying User
AccountRoles and Privileges - 6.3.2 Re[establishing]-setting a Textpattern- Admin Password[s]
in the MySQL Database - 6.4 Moving
TextpatternInstallations - 6.4.1
Moving Installation fromSubdirectory to Domain Rooton the Same Server - 6.4.2
Moving Installation fromRemote <strike>(Live)</strike> Server to Localhost - 6.4.3
Moving Installation from[O]ne Host to Another - 6.5 Multiple Installation Handling
- 6.5.1 Importing Article[s]
Contentfrom OneTextpatternInstall to Another - 6.5.2 Creating Multiple Subdomain Weblogs with One Textpattern Install <— Empty page, should we remove altogether?
- 7.1
Using Subversion (SVN) with a Textpattern Site- Using Subversion (SVN)
- 7.1.1
Repository to Windows Machine Using Graphical User Interface (GUI) Approach (via TortoiseSVN)- Repo to Windows via TortoiseSVN
- 7.1.2
Repository to Windows Machine Using Command Prompt Approach (via wget)- Repo to Windows via wget
- 7.1.3
Repository to Macintosh OS-X Machine GUI, GUI Snapshot, and Command Prompt Approaches<— maybe break this into two pages?- Repo to Mac OS-X
- 7.1.4
Repository to Linux Machine Using Command Prompt Approach- Repo to Linux
- 7.1.5
Repository to Web Server Using Webmin with TextDrive Hosting- TextDrive: Repo to Server via Webmin <— Is it necessary to indicate TextDrive?
- 7.1.6
Repository to Web Server Using Secure Shell (SSH) with TextDrive Hosting- TextDrive: Repo to Server via SSH <— ditto
- 7.2 <strike>Using Open-source Apache Packages for</strike> Local Development
- 7.2.1
Using XAMPP (Apache-MySQL-PHP-Perl) for Windows- XAMPP for Windows
- 7.2.2
Using MAMP (Macintosh-Apache-MySQL-PHP) for Macintosh- MAMP for Macintosh
- 7.3 Managing 404 Errors in a Textpattern Site <— delete?
- 7.4
Troubleshooting Common XHTML Validation Issues in a Textpattern Site(test link to article via original title)- Common XHTML Validation Issues (link to article via new title)
Offline
Re: [wiki] Call for suggestions for refined/improved page/topic titles in TxB
Here is a demonstration of wiki page title changes and the significance of it all. (From a wiki improvement standpoint, many titles do in fact need shortened.)
The original wiki page in this demonstration was first titles as Troubleshooting Common XHTML Validation Issues in a Textpattern Site. (A pretty long title indeed)
For demonstration purposes here, the page was “moved” (using wiki terminology) from one page title to another, which resulted in a redirect to the new page so that links are not broken. Old link labels like this one…Troubleshooting Common XHTML Validation Issues in a Textpattern Site (follow link and note the redirect indication at top of page) …that are in the Forum somewhere would be redirected to the new page, but the link label would then be incorrect. (Labels such as “here”, “this page” “in the wiki” and other lazy variations would not be an issue to worry about.)
The new page title is Common XHTML Validation Issues.
What does this all mean? It means three things:
- Links in the forum that go to old-titled wiki pages should ideally be edited to reflect the new titles if they were first written as full titles to begin with (lazy labels are not worth worrying about).
- More importantly, authors of posts where links were made to wiki pages should also change the link url so that it correctly points to the new page, and not the redirect, which will eventually be deleted. (The idea is to leave the redirect pages for a reasonable amount of time (6 months?) for them to get indexed properly, therafter delete them from the wiki. Once the old ones are axed, dead links will occur that are not changed.)
- We will use this thread as a reference to all titles in the current wiki ToC that that get changed and to what, thereby serving as a helpful reference for forum authors as links are gradually worked-out.
Offline
Re: [wiki] Call for suggestions for refined/improved page/topic titles in TxB
All this shortening worries me a little bit: when you translate english into another language, and typically italian, you usually end up with longer titles.
I hope we’ll be able to fit everything into this shorter lines. Please consider that other languages may need more space…
Ciao!
Offline
Re: [wiki] Call for suggestions for refined/improved page/topic titles in TxB
Thanks Macubu. I’m glad you brought that up. I understand what you are saying, it’s the same in French too, and probably many other languages.
Actually, what is being proposed here is not a limitation of the title space characters (as the word “shortening” might imply), a translator can still make titles as long as they need to, and the text will naturally wrap in the respective Main Page list boxes accordingly. In fact, the objective here of shortening the English titles would work in the favor of translation efforts, because it would be a shorter title that has to be translated to begin with, and if for a language (like Italian, French, etc) where titles can normally be quite long anyway (semantically speaking)…well, you can see where the advantage is here (shorter language titles and less work for the translators).
Offline
Re: [wiki] Call for suggestions for refined/improved page/topic titles in TxB
There’s another cool, little technique that the wiki allows that I had forgot about, and which may make all this title changing obsolete, though changing the titles would still be a much cleaner approach). See the last paragraph of this explanation.
Offline