Go to main content

Textpattern CMS support forum

You are not logged in. Register | Login | Help

#25 Yesterday 19:52:12

Bloke
Developer
From: Leeds, UK
Registered: 2006-01-29
Posts: 11,847
Website GitHub

Re: Docs site - changes not propagating; search broken

giz wrote #340163:

what if we used a suitably prepared Textpattern install as the starting point, and then manually entered each article?

Interesting. Getting stuff into Txp is relatively easy. No point doing it manually when a five line shell script can iterate through the entire current docs site and convert it to Textile for us.

Hacking out the repetitive parts of the tag docs and separating them is slightly more manual.

The hard part of the equation, though, is maintaining it. Running the docs from a static site with only a couple of core contributors is fine but for community docs, they need community involvement. And for that, as Pete says, we need a public change control repo which can do the heavy lifting back into the database.

Thus we need some way to have the files in a format that people can easily edit. But Txp needs to consume content automatically in a more machine-ready format.

Since we need this conversion process to take place anyway on a daily, hourly, whateverly basis, we might as well do the same thing to prepare the content in the first place. Hence the lowest common denominator is Markdown + some script to convert it ready for Txp to eat up.


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

Txp Builders – finely-crafted code, design and Txp

Online

#26 Yesterday 20:14:18

gaekwad
Server grease monkey
From: People's Republic of Cornwall
Registered: 2005-11-19
Posts: 4,407
GitHub

Re: Docs site - changes not propagating; search broken

Search tentatively working on non-Safari browsers.

Please test and report. Thank you.

Offline

#27 Yesterday 20:23:18

gaekwad
Server grease monkey
From: People's Republic of Cornwall
Registered: 2005-11-19
Posts: 4,407
GitHub

Re: Docs site - changes not propagating; search broken

Changes to source material now arriving as expected.

I’m calling this solved. What a day.

Offline

#28 Yesterday 21:40:44

giz
Member
From: New Zealand
Registered: 2004-07-26
Posts: 354
Website GitHub Twitter

Re: Docs site - changes not propagating; search broken

Pete & Bloke: thanks for the explanations. This devils advocate is silent now ;-)

Offline

#29 Today 10:11:09

etc
Developer
Registered: 2010-11-11
Posts: 5,419
Website GitHub

Re: Docs site - changes not propagating; search broken

gaekwad wrote #340169:

I’m calling this solved. What a day.

Esteem!

Offline

Board footer

Powered by FluxBB