Textpattern Forum

You are not logged in. Register | Login | Help

#1 2009-09-24 10:06:52

jsoo
Developer
From: NC, USA
Registered: 2004-11-15
Posts: 1,730
Website

[wiki] Tutorials page: layout & scope

Related to a more general topic about Txp tutorials, I think the TextBook tutorials category page would benefit from some reorganization. Visually, the page layout in three columns is a mess: even at a small-ish font size, one sees this:

B
   * Backing Up the 
     Textpattern 
     Database
   * Bilingual 
     Publishing 
     Without a Plugin

Listing articles alphabetically is not helpful for this category. You’re unlikely to know in advance the title of the article you want. Much more helpful to organize the titles by subject or sub-category. (Although I could see some benefit to having an alphabetical list below a list by subject, similar to the tag reference.) The current layout is tolerable because of the small number of articles, but it will quickly become worse as this number increases.

As to scope, I agree with Jonathan’s idea in the thread linked above that the TextBook tutorials should emphasize basic functionality. Possibly this should parallel TextBook’s “Main Topics” layout: Orientation, Installation, Administration, Tags & Designing, Extending.


Txp tags not doing what you expect? Learn to use a tag trace. And the Tag Reference.

Offline

#2 2009-09-24 15:08:16

Els
Admin
From: The Netherlands
Registered: 2004-06-06
Posts: 7,380
Website

Re: [wiki] Tutorials page: layout & scope

I like your idea. We need Destry or Patrick for the layout changes though…


<txp:Els /> ;)
Tag Reference | Unexpected behaviour? Check the tag trace | Still no clue? Check the names of your custom fields

Offline

#3 2009-09-25 01:36:43

JanDW
Plugin Author
From: Providence, RI, USA
Registered: 2008-07-18
Posts: 327
Website

Re: [wiki] Tutorials page: layout & scope

+1


TXPDream – A Textpattern Tag Library for Adobe Dreamweaver. (updated for 4.2.0) | jdw_if_ajax – Only serve certain parts of a page when requested with AJAX

Offline

#4 2009-09-26 20:53:09

Els
Admin
From: The Netherlands
Registered: 2004-06-06
Posts: 7,380
Website

Re: [wiki] Tutorials page: layout & scope

jsoo wrote:

Much more helpful to organize the titles by subject or sub-category. (Although I could see some benefit to having an alphabetical list below a list by subject, similar to the tag reference.)

Like on the Tag Reference page, we could have a list of sub-categories first, and then the alphabetical list. If you have a proposal how to categorize, I’ll be happy to add it.
About the three column layout: it seems to be a general layout, applied to all category pages. Don’t know if it’s possible to change it only for the tutorials page. Anyway, Destry doesn’t seem to be around much at the moment, so I think we need to use the current layout for now. Though maybe Nora could help us out. If not, would it be an idea to try and trim the article’s titles?

We are also planning to re-open the How-tos and examples forum because it’s less of a threshold for people to post their ideas here than in Textbook or offering it to Jonathan for TXP Tips. Topics in that forum that are suited for Textbook will be moved there eventually, and the same could apply to TXP Tips, if Jonathan agrees.


<txp:Els /> ;)
Tag Reference | Unexpected behaviour? Check the tag trace | Still no clue? Check the names of your custom fields

Offline

#5 2009-09-26 21:37:46

jsoo
Developer
From: NC, USA
Registered: 2004-11-15
Posts: 1,730
Website

Re: [wiki] Tutorials page: layout & scope

Els wrote:

Like on the Tag Reference page, we could have a list of sub-categories first, and then the alphabetical list.

Exactly what I had in mind.

If you have a proposal how to categorize, I’ll be happy to add it.

Thinking to parallel TextBook’s “Main Topics” layout (Orientation, Installation, Administration, Tags & Designing, Extending), here is a possible scheme using current tutorials:

  • Orientation
    • Txp 101
    • Txp First Steps
  • Installation
    • Making Txp more secure
    • Merging the contents…
    • Multiple sites
  • Administration
    • Backing up
    • User accounts
    • Resetting admin pw
    • clean URLs
    • more secure
    • Combat spam
    • Maintaining a development installation
      • MAMP (currently 2 articles)
      • XAMP
      • Mac roll your own
    • Unicode
  • Site design/architecture
    • Bilingual
    • Photoblog
    • Archive by month
    • XHTML validation
    • .htaccess protection
    • Podcasting
    • Portfolio
    • Author profiles
    • FAQ
    • Geoblogging
  • Extending (currently empty)

About the three column layout: it seems to be a general layout, applied to all category pages. Don’t know if it’s possible to change it only for the tutorials page. Anyway, Destry doesn’t seem to be around much at the moment, so I think we need to use the current layout for now. Though maybe Nora could help us out. If not, would it be an idea to try and trim the article’s titles?

Trimming titles would help a bit, but would be a cosmetic solution to a semantically structural problem. I think it would be better to create a new page with a hand-maintained list; tutorials aren’t flooding in at such a rate that this would be unreasonable.

We are also planning to re-open the How-tos and examples forum

Sounds good.


Txp tags not doing what you expect? Learn to use a tag trace. And the Tag Reference.

Offline

#6 2009-09-27 00:14:01

Els
Admin
From: The Netherlands
Registered: 2004-06-06
Posts: 7,380
Website

Re: [wiki] Tutorials page: layout & scope

jsoo wrote:

here is a possible scheme using current tutorials:

Sub-categories 1-4 created. Now the existing pages can be added to those.


<txp:Els /> ;)
Tag Reference | Unexpected behaviour? Check the tag trace | Still no clue? Check the names of your custom fields

Offline

#7 2009-09-27 00:57:07

jsoo
Developer
From: NC, USA
Registered: 2004-11-15
Posts: 1,730
Website

Re: [wiki] Tutorials page: layout & scope

Els wrote:

Sub-categories 1-4 created. Now the existing pages can be added to those.

Done. A step in the right direction.


Txp tags not doing what you expect? Learn to use a tag trace. And the Tag Reference.

Offline

#8 2009-09-27 12:12:12

Els
Admin
From: The Netherlands
Registered: 2004-06-06
Posts: 7,380
Website

Re: [wiki] Tutorials page: layout & scope

Thanks Jeff!

I’m not so happy about the sub-category names I created (01 Installation etc.), but since the categories are being ordered alphabetically it would otherwise have resulted in a not so logical presentation… If anyone has a better idea I’d love to hear it.

Now we just have to wait for one of the Textbook admins to have their say about the layout.


<txp:Els /> ;)
Tag Reference | Unexpected behaviour? Check the tag trace | Still no clue? Check the names of your custom fields

Offline

#9 2009-09-28 01:49:49

uli
Moderator
From: Cologne/Köln
Registered: 2006-08-15
Posts: 3,017

Re: [wiki] Tutorials page: layout & scope

Els wrote:

I’m not so happy about the sub-category names I created (01 Installation etc.), but since the categories are being ordered alphabetically it would otherwise have resulted in a not so logical presentation… If anyone has a better idea I’d love to hear it.

Not an idea, rather a find. From an entry on Adding a new English FAQ page:

5. Add the following to the bottom of page <!-- Keep at bottom --> [[category:FAQs|z]] (add line break after comment) where “z” is the letter (a through z) of how you want the FAQ to be alphabetized in the category listing (note this is one reason by which to base your retitling, as well as to prevent all FAQs filing under “f” for “faq:”). If you happen to need “z,” leave it as “z”.

Perhaps applicable. Magnana.


In bad weather I never leave home without wet_plugout, smd_where_used and adi_form_links

Offline

#10 2009-09-28 02:34:51

jsoo
Developer
From: NC, USA
Registered: 2004-11-15
Posts: 1,730
Website

Re: [wiki] Tutorials page: layout & scope

Good find, Uli! Still slightly odd in that the sorting letters still show up on the Tutorials page, but much better than before. I’ve made the changes.


Txp tags not doing what you expect? Learn to use a tag trace. And the Tag Reference.

Offline

Board footer

Powered by FluxBB