[docs] Anchors in Markdown?

hcgtv · 2016-09-05 20:57:06

Destry,

Is the official tag reference using Textpattern?

If it is, it sure looks like duplication of effort to me.

Maybe you missed the memo that was circulating?

jakob · 2016-09-05 22:06:55

hcgtv wrote #301077:

Destry,

Is the official tag reference using Textpattern?

I don’t think it is anymore. The latest version is I believe maintained on github and built with jekyll. It should still be possible to bring it over to txptags, though?

BTW: on a side note, I’d love to see a phpxref of the new 4.6 branch. Things have changed quite a bit since 4.5.7.

hcgtv · 2016-09-05 22:27:47

jakob wrote #301082:

BTW: on a side note, I’d love to see a phpxref of the new 4.6 branch. Things have changed quite a bit since 4.5.7.

Yes, they have. When I have the chance, I’ll zip up the 4.6 CrossRef and provide you a link.

jakob · 2016-09-06 00:03:05

Brilliant. It really is a useful resource for following how things work.

hcgtv · 2016-09-06 06:11:40

jakob wrote #301087:

Brilliant. It really is a useful resource for following how things work.

Muchas gracias senor – Textpattern 4.6.0 beta 3ish.

Destry · 2016-09-06 14:45:06

I don’t think the Tag Reference was ever on Textpattern after the wiki. I believe Jakob is right, it went strait to Jekyll pages. That part of the docs — tag pages — is Phil’s baby. I’m only trying to write the other doc pages (e.g. admin-side, etc), most of which are still missing on the new side, and there is no duplication of effort on those, that I’m aware of.

My gripe was having to redo Textile to Markdown for the rather detailed pages I have edited so far. But that’s nobody’s fault. Just typical migration necessity stuff due to platform changes, etc. I’ve not had much time these last months to do anything, but I’d sure rather write/edit words that farc around with formatting syntax. The train will continue to roll along slowly.

hcgtv · 2016-09-06 14:59:43

Destry wrote #301119:

That part of the docs — tag pages — is Phil’s baby.

Well it’s running Textpattern, see the txp:article page.

I just found it really strange, there’s always been a reluctance towards my efforts.

I’ll dig through the sources and update TXP Tags for 4.6.

philwareham · 2016-09-06 15:08:37

It’s Jekyll-powered.

Note that this isn’t a tags site per se – it’s the Textpattern User Documentation site which used to be a Wiki on Textpattern.net. The tags section is just part of that documentation.

I’ve discussed the reasoning behind choosing GitHub’s Jekyll in other threads, but basically it was chosen because the flat files can be collaboratively worked on by GitHub users, and version controlled. It also shares CSS with the upcoming Textpattern.com site and possibly this forum too if I do some work on that soon – which minimises future maintenance.

Destry · 2016-09-06 15:41:03

Destry wrote #301119:

That part of the docs — tag pages — is Phil’s baby.

All I mean by that is it was a division of labor. Phil originally began the docs migration away from the wiki to GitHub, and he sensibly started with the most important part, the Tag Reference. By the time I got involved, the tag pages were mostly done, so I started in with the other sections, and it’s just kind of been that MO ever since. I’d assume once the beast is mostly assembled, there will be more editing across any page by those with write access on the user docs repo. No territorial lines, sensibly.

hcgtv · 2016-09-07 04:57:55

philwareham wrote #301121:

It’s Jekyll-powered.

I say we ditch Textpattern and go with Jekyll ;)

michaelkpate · 2016-09-07 14:10:41

hcgtv wrote #301130:

I say we ditch Textpattern and go with Jekyll ;)

I get the appeal of Jekyll for single-user sites or very technically-inclined multi-users or people desperate for cheap hosting but other than that…

gaekwad · 2016-09-07 14:14:51

michaelkpate wrote #301169:

I get the appeal of Jekyll for single-user sites or very technically-inclined multi-users or people desperate for cheap hosting but other than that…

It plays really well with GitHub, which means a lot of stuff can be collaboratively worked on, with version control.

Oh, and flat files == no inherent CMS to maintain, which is a bonus.

Textpattern CMS

Textpattern CMS support forum

#13 2016-09-05 20:57:06

Re: [docs] Anchors in Markdown?

#14 2016-09-05 22:06:55

Re: [docs] Anchors in Markdown?

hcgtv wrote #301077:

#15 2016-09-05 22:27:47

Re: [docs] Anchors in Markdown?

jakob wrote #301082:

#16 2016-09-06 00:03:05

Re: [docs] Anchors in Markdown?

#17 2016-09-06 06:11:40

Re: [docs] Anchors in Markdown?

jakob wrote #301087:

#18 2016-09-06 14:45:06

Re: [docs] Anchors in Markdown?

#19 2016-09-06 14:59:43

Re: [docs] Anchors in Markdown?

Destry wrote #301119:

#20 2016-09-06 15:08:37

Re: [docs] Anchors in Markdown?

#21 2016-09-06 15:41:03

Re: [docs] Anchors in Markdown?

Destry wrote #301119:

#22 2016-09-07 04:57:55

Re: [docs] Anchors in Markdown?

philwareham wrote #301121:

#23 2016-09-07 14:10:41

Re: [docs] Anchors in Markdown?

hcgtv wrote #301130:

#24 2016-09-07 14:14:51

Re: [docs] Anchors in Markdown?

michaelkpate wrote #301169:

Board footer