search

TEIC / website

TEI Development Website
1 stars 1 forks source link

Customization page: broken links #4

Closed ebeshero closed 2 weeks ago

ebeshero commented 1 month ago

As reported on the TEI-L list, these (and other) links providing guidance on ODDs aren't working:

ebeshero commented 1 month ago

A bit more detail on the problem: Pages like Customization had a sidebar on the old site where the links work properly, but they won't work in the main page.

The links reported as broken in the TEI list are there in the old site, with these addresses: Getting Started with P5 Odds: https://old.tei-c.org/guidelines/customization/getting-started-with-p5-odds/ (As "Using Roma" in the sidebar): Customizing the TEI wtih Roma: https://old.tei-c.org/guidelines/customization/customizing-the-tei-with-roma/

I think we just need to import those pages to this repo.

hcayless commented 1 month ago

Let me start by saying that I really don't want to be an ass about this, but we're getting a little past the stage here of "let's just have Hugh do it".

Both of these pages are obsolete and occasionally broken. The Roma page is really obsolete, since it's documentation for Roma Antiqua. The Odds page has missing content and should probably reference Lou's tutorial (which, incidentally, we ought to once and for all decide how to handle--there's other possibly less significant stuff in TEI/Documents too).

I want to institute a principle of not just importing broken shit into the new website. That is how we got the unmaintainable mess we had in WordPress. I would rather remove links to stuff we can't supply yet. But we also need to figure out a structure for handling things like this.

hcayless commented 1 month ago

In the interim, I have removed the broken links.

lb42 commented 1 month ago

Not sure exactly what "being an ass" means in Hugh's dialect, but I whole heartedly support making my ODD tutorial material a bit more visible! To be honest, I hadn't realised it had been purged from the website or I might have been making myself an ass too.

ebeshero commented 1 month ago

Sorry, @hcayless ! I opened this quickly this morning and just had time to locate the old pages, not look at them closely. I just thought there was an import problem, and figured I should open a ticket here in case you knew of a quick fix. I'm sorry that it's more of a slow fix at the content level--and we'll likely find that's the case for a lot of the interior links.

The customization resources are important to the community (as we saw by Katarzyna's post to the list this morning), so I'd like to restore and improve them. I guess I'll assign that to myself.

ebeshero commented 1 month ago

For the slow work of improving the Customization page, the unfolding discusson on the TEI-L may be helpful: https://lists.psu.edu/cgi-bin/wa?A2=TEI-L;6c65a542.2409&S=

lb42 commented 1 month ago

There are links to other customization documentation materials at the end of an introductory lecture I gave in 2021: see https://lb42.github.io/Talks/2021-09-28-odd.pdfhttps://lb42.github.io/Talks/2021-09-28-odd.pdf

From: Elisa Beshero-Bondar @.> Sent: Friday, September 6, 2024 5:06 PM To: TEIC/website @.> Cc: Lou Burnard @.>; Comment @.> Subject: Re: [TEIC/website] Customization page: broken links (Issue #4)

For the slow work of improving the Customization page, the unfolding discusson on the TEI-L may be helpful: https://lists.psu.edu/cgi-bin/wa?A2=TEI-L;6c65a542.2409&S=

— Reply to this email directly, view it on GitHubhttps://github.com/TEIC/website/issues/4#issuecomment-2334381098, or unsubscribehttps://github.com/notifications/unsubscribe-auth/AAFBJ5EJ2ETPNEOAJL2E4ZLZVHHJXAVCNFSM6AAAAABNYQYIXGVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDGMZUGM4DCMBZHA. You are receiving this because you commented.Message ID: @.***>

hcayless commented 1 month ago

@lb42 I imagine you can guess :-). I don't think it was purged so much as never properly integrated in the first place—largely because of Wordpress's inability to handle XML. The new website can handle TEI just fine, it's just a question of how best to do it.

lb42 commented 1 month ago

I am delighted to learn the new website can handle TEI just fine (il était temps) : is that with CETEICEAN?

I've also now remembered that I made a quick backup repo for my ODD documentation stuff at

https://lb42.github.io/ODD/

but somehow omitted to tell anyone.

From: Lou Burnard @.> Sent: Friday, September 6, 2024 5:11 PM To: TEIC/website @.> Subject: Re: [TEIC/website] Customization page: broken links (Issue #4)

There are links to other customization documentation materials at the end of an introductory lecture I gave in 2021: see https://lb42.github.io/Talks/2021-09-28-odd.pdfhttps://lb42.github.io/Talks/2021-09-28-odd.pdf

From: Elisa Beshero-Bondar @.> Sent: Friday, September 6, 2024 5:06 PM To: TEIC/website @.> Cc: Lou Burnard @.>; Comment @.> Subject: Re: [TEIC/website] Customization page: broken links (Issue #4)

For the slow work of improving the Customization page, the unfolding discusson on the TEI-L may be helpful: https://lists.psu.edu/cgi-bin/wa?A2=TEI-L;6c65a542.2409&S=

— Reply to this email directly, view it on GitHubhttps://github.com/TEIC/website/issues/4#issuecomment-2334381098, or unsubscribehttps://github.com/notifications/unsubscribe-auth/AAFBJ5EJ2ETPNEOAJL2E4ZLZVHHJXAVCNFSM6AAAAABNYQYIXGVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDGMZUGM4DCMBZHA. You are receiving this because you commented.Message ID: @.***>

ebeshero commented 1 month ago

@lb42 @hcayless I added several resources to the customization page (thanks partly to that slide of yours, Lou)! How does this look? https://tei-c.org/guidelines/customization/

lb42 commented 3 weeks ago

I think this page (https://tei-c.org/guidelines/customization/) ought to be linked to from https://github.com/TEIC/website/blob/main/src/support/learn.md rather than the current link to https://github.com/TEIC/website/blob/main/guidelines/customization/getting-started-with-p5-odds

ebeshero commented 2 weeks ago

Done last week--and thank you!