search

YeOldeInn / agins-archive

Archive of Agin's Inn, the predecessor to Ye Olde Inn
1 stars 0 forks source link

TODO #1

Open knghtbrd opened 2 years ago

knghtbrd commented 2 years ago

Here's the list of things that need to be done for the Agin's Inn archive

What else ought to be done? Comment below. How much time/effort do we want to spend on the historical archive? I want the site's broken links resolved at least.

knghtbrd commented 2 years ago

Since we don't have Dewayne Agin to 👍 or 👎 any license (he kinda left it all in drathe's hands) and so many other contributors to that site are now basically just gone now, it needs to be something respectful to all of them and what I think their clear intention was.

It's clear from the eBay dude selling $45 decks of homebrew cards off the Inn that we can't actually stop bad people from doing bad things, but a basic "give credit and don't be a dick or we're all going to mock and ridicule you" sort of license is all we can realistically hope for. It's certainly all we've generally been able to enforce.

Sorely tempted:

This content was created by fans of HeroQuest. It is made for and occasionally partially derived from
HeroQuest in ways we believe were intended and are permitted by HeroQuest's owner. Use what you
find in whatever way seems like fun. Giving credit where due is appreciated, and please don't be like
that douche selling $45 decks of cards he downloaded off YeOldeInn on eBay.

I've written actual licenses before. They're rarely that much fun to read. 🤣

DaedalusInn commented 2 years ago

Love that license!

knghtbrd commented 2 years ago

LOL, I wrote something down a little more "proper" I was going to post over at the Inn for feedback, but I figured for the time being it can wait, but I wrote it before a conversation I had over the weekend that might ever so slightly change what it probably ought to say. It should be fine to leave it as it is for the moment since all that's here now are a bunch of HTML files and a few website graphics. I dunno if I want to put the various downloads into git or not.

I have at least that long before I really ought to come up with something and I think I really should clean up some HTML first. I didn't plan on it, but fixing the thing to display on 1080p much less 4k screens makes it kind of important.

knghtbrd commented 2 years ago

Edited to reflect the sub-steps of the first goal. The HTML files are in git. The images are … lemme do some figuring. This is gonna look like line noise…

tjcarter@aki:~/YeOldeInn/agins-archive$ grep -l '^<!-- ##' $(find -name \*.htm\*) | wc -l
93
tjcarter@aki:~/YeOldeInn/agins-archive$ grep -L '^<!-- ##' $(find -name \*.htm\*) | wc -l
115

I've been through 93 files, and I have 115 left to look at to add images. Many of these don't have any images and only need one line added to them (a comment line in the HTML code I'm adding as I go). Those are quick. The others take a little longer. More figuring (skipped), 66 of the 115 have images that may need to be added to the archive. That means … yup, 49 … 49 do not.

If you don't want an explanation for that crazy unixy grep stuff above, you can skip the rest of this comment. It's not necessary to help with any of this stuff, but might be of interest if you've been learning UNIX command line stuff for Linux or Mac, or WSL usage. I've just gotten into explanation mode with the se things, so may as well continue the trend.

Remember how in math class you would do stuff in () first? In this case, we do what's in $() first. That's "find -name *.htm*". That spits out a list of all HTML files in the tree. Save one that should be in the tree and isn't because I know it's a duplicate already and it's got spaces in the filename. Those add to the complexity of unixy stuff like the above, so since I know I will be deleting that file anyway, I've not added it to the repository. I'll compare it against its near identical dupe … sooner or later.

Okay so now we have a list of files. Well, the $() bit takes that list (normally one per line) and glues them all together as a list of files on one line. Then there's the grep part. Let's go with the first one, grep -l '^<!-- ##'. I said I'm adding a comment to the end of files as I go. Here's one:

<!-- ##2## -->

To make a comment in a web page, you start it with <!-- and finish it with -->. And at this point, I have to of those: ##2## and ##ORPHAN##. I used those because they're not going to appear anywhere else in any of the files if I don't put it there. I can search for any file that's been through stage 2 with grep -l '##2##'. The -l stands for list, as in list files that match. So I'm looking for any file above that matches '^<!-- ##' which means any file containing the start of an HTML comment followed by a space and two number signs. If you hadn't guessed, in the second line, I use -L which says give me a list of files that DON'T have that in them.

If you know that you can use `` for "subshell", $() is a so-called "bashism" that does the same thing. Except it can be nested! Which means if I want to tale a list of files that don't have my comment indicating I've "processed" them and search for images within, yup, I can $() and precede it with grep -l 'src='. or -L if I want the list that don't. This is all 1970s tech, chaining commands together to get what you want. On Windows, PowerShell does the same kind of things, it just does it with "objects" rather than text, and Microsoft makes you type a lot more verbiage because PowerShell was designed by a frickin' committee of pretentious intellectuals who wanted to "design the perfect system" on multi-gigahertz systems with boat loads of RAM as opposed to code monkeys who just wanted to get shit done on machines that might have 32. Kilobytes, not gigabytes.

knghtbrd commented 2 years ago

Hey @DaedalusInn, how's this?

HeroQuest, Avalon Hill, all associated Trademarks, and the Copyright to HeroQuest are owned by Hasbro, Inc. This site is not intended to challenge Hasbro's rights or commercial interests.

Agin's Inn is the work of fans who provide their creations to use, improve, and share freely. Anything commercial requires their permission. And maybe Hasbro's. Good luck with that!

I think it covers what needs covering.

DaedalusInn commented 2 years ago

The copyright disclaimer looks good to me!