Go to main content

Textpattern CMS support forum

You are not logged in. Register | Login | Help

#136 2008-08-19 16:25:26

zero
Member
From: Lancashire
Registered: 2004-04-19
Posts: 1,475
Website

Re: [wiki] A New Textbook

I’ve rewritten article custom and article to the latest format. Please scrutinize. Points to ponder:
  • Is ‘unset’ the same as ‘empty’ or is there a difference for coding reasons? I’d like to make them all ‘unset’ if they are the same.
  • ‘more-info’ is now value-info and has more values
  • ‘table-textpattern’ is now table
  • ‘Posted’ is now ‘posted’. I intend to make all lowercase except those in the textpattern table.
  • See Also has more links

Any more suggestions before I plough on (slowly because there’s a lot to change)?


Dozy P My attempt at music

Offline

#137 2008-08-19 16:47:08

ruud
Developer Emeritus
From: a galaxy far far away
Registered: 2006-06-04
Posts: 5,068
Website

Re: [wiki] A New Textbook

  • Posted should be written with a capital P (that’s how it is in the textpattern table)
  • I think ‘value-info’ should be ‘attribute-type’ or ‘attribute-data-type’ or ‘data-type’, because a tag value can mean something else as well.
  • Should I put all the table layouts in /ref/table? Shouldn’t be a problem with some #anchors here and there, similar to the attribute data types.
  • Instead of “form name” and “section name”… perhaps use just “form” and “section”, because the attribute type page will explain it in detail anyway? It may be more consistent that way (compared to types like “integer” [not ‘integer number’] and “text” [not ‘text string’].

Last edited by ruud (2008-08-19 16:51:06)

Offline

#138 2008-08-19 17:33:57

zero
Member
From: Lancashire
Registered: 2004-04-19
Posts: 1,475
Website

Re: [wiki] A New Textbook

Aaargghh! Thank God you spotted the Posted, Ruud! I copied the textpattern table and pasted into my text editor for my reference and missed copying the first two – ID and Posted – so thought they must be lowercase :-(

It is now data-type and names have been changed

I don’t know what the tables will contain, Ruud, so I leave that up to you. If there should be more than one, please let me know their names.


Dozy P My attempt at music

Offline

#139 2008-08-19 23:03:07

ruud
Developer Emeritus
From: a galaxy far far away
Registered: 2006-06-04
Posts: 5,068
Website

Re: [wiki] A New Textbook

Peter, I’ve finished about half of the table layout reference now. I’ll probably do the rest tomorrow. More work than I thought.

Offline

#140 2008-08-20 11:15:32

zero
Member
From: Lancashire
Registered: 2004-04-19
Posts: 1,475
Website

Re: [wiki] A New Textbook

Oooh, yes, more than I thought too. I was thinking it was mainly going to be about tips on sorting etc.

With it being a definitive reference to those database tables, it seems inappropriate to include sorting tips etc with it. If at all they should be in a separate article. For people who aren’t coders it won’t make any sense to put just a few sort values with an attribute and then point them to the table (as you have done in recent_articles). So I thought I’d continue to include all the values, as in article and articlecustom but put a reference to the table for coders benefit. OK?


Dozy P My attempt at music

Offline

#141 2008-08-20 11:21:08

ruud
Developer Emeritus
From: a galaxy far far away
Registered: 2006-06-04
Posts: 5,068
Website

Re: [wiki] A New Textbook

I’ll put sorting tips on the data-type page, where the sorting criteria are explained. This will include things like multi-level sorting and random sorting.
Listing all columns just makes it messy, because there are simply too many in the textpattern table (or most other tables, for that matter). That’ll just confuse the reader. This is why I listed only the 2 or 3 most commonly used columns for recent_articles, so the user can get started. Those that need more can click for more info.

Last edited by ruud (2008-08-20 11:25:28)

Offline

#142 2008-08-20 11:33:42

Bloke
Developer
From: Leeds, UK
Registered: 2006-01-29
Posts: 12,513
Website GitHub

Re: [wiki] A New Textbook

ruud

In my sole capacity as TXP redesign cheerleader (thus far, until I can be of use for content elsewhere) can I publicly state that the table layout reference you put together rocks! That’s going to be very handy when linked from main articles and also a useful document to keep open in a browser tab when developing. Nice work.

(btw, the link to the ref table needs changing from the recent_articles page)


The smd plugin menagerie — for when you need one more gribble of power from Textpattern. Bleeding-edge code available on GitHub.

Hire Txp Builders – finely-crafted code, design and Txp

Offline

#143 2008-08-20 12:25:43

zero
Member
From: Lancashire
Registered: 2004-04-19
Posts: 1,475
Website

Re: [wiki] A New Textbook

recent_articles updated and finished


Dozy P My attempt at music

Offline

#144 2008-08-20 17:57:04

mrdale
Member
From: Walla Walla
Registered: 2004-11-19
Posts: 2,215
Website

Re: [wiki] A New Textbook

I always liked the link to conditional tags in the existing txB.

Offline

#145 2008-08-20 19:13:32

zero
Member
From: Lancashire
Registered: 2004-04-19
Posts: 1,475
Website

Re: [wiki] A New Textbook

The conditional tags are now part of the Tag Syntax page with links from every tag article. You’ll get used to it :-)


Dozy P My attempt at music

Offline

#146 2008-08-21 08:08:08

FireFusion
Member
Registered: 2005-05-10
Posts: 698

Re: [wiki] A New Textbook

When this become the official Textbook can it go on wiki.textpattern.com rather than textpattern.net? I always thought the multiple domain thing made no sense.

Offline

#147 2008-08-21 13:35:50

zero
Member
From: Lancashire
Registered: 2004-04-19
Posts: 1,475
Website

Re: [wiki] A New Textbook

Tag articles are now updated.

There should be no confusion about Textbook. As I said at least twice before, the one I am working on will become the official txb for a short time or for a long time if the community wants it. Otherwise it will be binned. There will only be one Textbook. Sorry Jakob I should have made this clear when you asked previously, I can’t expect everyone to read every post.

The content on the new textbook is up to date, easy to follow and people prefer it to your existing Textbook. So it is ready to become the official textbook when 4.0.7 is launched. If the community wants to wait for Destry to get his mediawiki version together then so be it. We have seen his mockup of an inner content page and people enthused about the integrated concept. However, that does not mean they enthused about the Textbook part of it, so don’t get carried away just yet, Destry. The new textbook can easily fit in below the Textpattern header and menu – a little bit of style change will be needed but my style was always temporary anyway, I always said it would be styled to fit the txp.com relaunch.

We don’t know what Destry’s home page, contents pages etc will be like, but looking at his mockup, they won’t be much different to the existing Textbook, with the content surrounded on all sides by one thing and another. Of course if Destry can get a better txb up and running by the time of 4.0.7, then I am sure the community will go for that one. But it’s a big if, imho.


Dozy P My attempt at music

Offline

#148 2008-08-21 15:29:23

mrdale
Member
From: Walla Walla
Registered: 2004-11-19
Posts: 2,215
Website

Re: [wiki] A New Textbook

zero wrote:

The conditional tags are now part of the Tag Syntax page with links from every tag article. You’ll get used to it :-)

Yeah, understand that. Just a usability issue. Conditional tags are functionally different which would make a page that lists all conditionals or a grouping of conditionals very useful. This shouldn’t be difficult with tags/categories/whatever taxonomic device.

Offline

#149 2008-08-21 15:38:40

ruud
Developer Emeritus
From: a galaxy far far away
Registered: 2006-06-04
Posts: 5,068
Website

Re: [wiki] A New Textbook

Perhaps on the tag by function page, there could be an extra grouping of conditional tags (even if they’re already listed in various other places on that page).

Offline

#150 2008-08-21 15:44:38

mrdale
Member
From: Walla Walla
Registered: 2004-11-19
Posts: 2,215
Website

Re: [wiki] A New Textbook

BTW: the whole conditional thing dichotomy is not for me… It’s just something I found immensely useful when I was learning TXP, and think that others would benefit it.

Offline

Board footer

Powered by FluxBB