#dev 2022-03-08

2022-03-08 UTC
jacky joined the channel
#
jacky
I wanted to repeat a syndication attempt - but the change you made works for my case (making it seem idempotent on my end by checking the error for some text + properties)
jacky, marksuth[d] and Seirdy joined the channel
#
Seirdy
I typically annotate my bookmarks with a description so I remember what they're about when I later refer to them. An example of the raw data is at https://seirdy.one/data/bookmarks.json. I'm wondering whether I should mark them up as bookmarks or replies. If I mark them up as bookmarks, should I use "p-summary" or "e-content" for the descriptions?
#
Seirdy
(sharing a paste of the current markup in a min)
#
Seirdy
current markup of a single bookmark in a <ul>: https://termbin.com/1280
#
Seirdy
(I haven't marked up the tags properly yet, i'll get to that later)
#
jacky
I think /bookmarks has some info (but I'm thinking e-content)
#
jacky
what are bookmarks
#
Loqi
bookmarks are sometimes part of the information about a post displayed on the post itself, sometimes in a post footer, like a total number bookmark responses, icons of recent bookmarkers, or even a datetime ordered list of bookmarks https://indieweb.org/bookmarks
#
Seirdy
jacky: i checked there and it seemed to imply that if you add commentary, it should be considered a "reply" and not a "bookmark"
#
Seirdy
some of my description do contain commentary, but most are just descriptions.
#
jacky
hmm I guess /quotations would work then!
#
Seirdy
i'm not including any quotations
#
Seirdy
from the sources
#
Seirdy
the descriptions are original
#
jacky
I would do the u-bookmark-of with e-content
#
jacky
I _could_ see the case for using e-note instead (b/c e-content is specific to being the _content_ of a post whereas e-note/p-note are like markers by the poster about the post itself)
#
Seirdy
what's the diff between -note and -content?
#
Seirdy
the mf2 page doesn't really define that
#
Seirdy
cuz in this context, the content would be the bookmarking, not the thing being bookmarked
#
Seirdy
hmm, e-note looks like a good choice if they're just an attachment to a post and not the post itself. but they should have the same weight as the timestamp. the timestamp describes the act of bookmarking, not the content being bookmarked; wouldn't an "-entry" be the same at that point in the dom tree?.
#
GWG
Seirdy: Where do you see e-note?
#
Seirdy
GWG: I see "-note", which can have the "p" or "e" prefix.
#
GWG
Seirdy: See where, I mean? On what page?
#
Seirdy
oh one sec
#
GWG
I usually only see note on h-card
#
GWG
Bookmark would generally have a -summary
#
Seirdy
GWG: oh that makes sense
#
Seirdy
ah i switched up "-note" and "-summary"
#
GWG
So, -content is full content, -summary is a summary.
#
Seirdy
yeh summary looks like a good fit in this case
#
Seirdy
since i am summarizing the content, not quoting/replying-to/reposting it
#
GWG
Summaries are usually plaintext(p-), but can be full HTML(e-).
#
Seirdy
yeah mine are full html
#
Seirdy
since i have <abbr>s and links
#
Seirdy
for now
#
Seirdy
k fixed those microformats and cleaned up the microdata, time to figure out the tags.
#
Seirdy
im generating the JSON from buku (https://github.com/jarun/buku) and piping it through "ssh <target> tee /var/www/.../bookmarks.json" and then pulling in the json in Hugo. I love this setup, no need for a dynamic site; i just re-build every now and then. the site builds in milliseconds.
#
Loqi
[jarun] buku: :bookmark: Personal mini-web in text
#
Seirdy
i can do the same with music ratings since i rate tracks out of 10 in mpd. i can just query my stickers database for tracks and ratings and have hugo pull that in too.
#
GWG
The idea is that everything should be able to interpret summary if it doesn't know other things
mceldeen and mro joined the channel
#
capjamesg[d]
I would mark up each entry as a h-entry object and then the whole page as a h-feed.
#
capjamesg[d]
YimingWu[d]
#
capjamesg[d]
> Also... I write my blog in a thread like fashion, much like twitter, where I append certain topics from time to time, for this kind of structure would it be best to microformat the whole thread as one passage, or to format so it's individual posts?
#
capjamesg[d]
If your page is marked up in this way, readers that can parse microformats (of which there are quite a few in this community) will be able to parse your page and subscribe.
#
YimingWu[d]
capjamesg[d] My home page consists of latest posts from different threads, so I should also format into h-entry individually and h-feed for the whole page right?
mro and [tw2113_Slack_] joined the channel
#
YimingWu[d]
Also is there a way to specify which links not to index for indie search or other crawlers? otherwise the structure of my page would lead to way too much duplicated copies when indexing
#
capjamesg[d]
Yes, each post should be marked up as a h-entry.
mro joined the channel
#
capjamesg[d]
You can see an example of how to do this by looking at my home page: https://jamesg.blog
#
capjamesg[d]
My home page is a combined list of notes and blog posts.
#
capjamesg[d]
To ensure a search engine doesn't index the content on a page, you should either exclude the page or directory in a robots.txt file or you should specify a noindex directive on the page you don't want to show up in a search page.
#
capjamesg[d]
Big search engines like Google are good at catching duplicate content.
#
capjamesg[d]
IndieWeb Search is still improving in that regard but will pick up on identical content and ensure it is not indexed.
#
capjamesg[d]
You can also use a rel=canonical to tell search engines where to find the "main" version of a page.
#
YimingWu[d]
Ah that's a useful piece of hint... I shall look into that rel solution
#
YimingWu[d]
I checked out your site's html, looks like every post you also have a h-card photo inside each h-entry
#
YimingWu[d]
From my understanding this kind of arrangement is largely free and it should make sense in most cases then it's alright?
#
capjamesg[d]
What is a canonical?
#
Loqi
The canonical copy of a piece of content is the “truest” copy https://indieweb.org/canonical
#
capjamesg[d]
What is robots.txt?
#
Loqi
It looks like we don't have a page for "robots.txt" yet. Would you like to create it? (Or just say "robots.txt is ____", a sentence describing the term)
#
capjamesg[d]
What are robots?
#
Loqi
robots are automated scripts that crawl, search, or perform requests for information https://indieweb.org/robots
#
capjamesg[d]
Here is some good guidance on how to create a robots.txt file: https://developers.google.com/search/docs/advanced/robots/create-robots-txt
#
capjamesg[d]
[edit] Here is some good guidance on how to create a robots.txt file: https://developers.google.com/search/docs/advanced/robots/create-robots-txt
mro joined the channel
#
[KevinMarks]
I would suggest -summary rather than -note - the usual expansion is name/summary/content and a classic link blog is summary rather than note
#
[KevinMarks]
@sierdy if you are rating things, look at h-review markup which helps discovery of your ratings by search engines and potentially as webmentions
mro joined the channel
#
capjamesg[d]
[James_Van_Dyne] I shall need to have a think about what tasks need done for the next release of indieweb utils. I apologise for this taking as long as it has. I have had lots of other things going on.
[James_Van_Dyne] joined the channel
#
[James_Van_Dyne]
capjamesg: No worries, mate. Have had heaps going on here as well. Life happens 🙂
#
[James_Van_Dyne]
Hoping to get my packer/uwsgi Tanzawa finished soon so I can start coding again. Devopsy stuff always takes me a while and is not nearly as much fun for me.
#
capjamesg[d]
I wish I had a "devops" red button on my desk that did all of the devops work 😂
#
capjamesg[d]
But unfortunately we're nowhere near having anything like that since the button itself would have to decide on infrastructure, etc. 😂
tetov-irc and jacky joined the channel
#
jacky
GWG: this might be useful to you https://github.com/Waboodoo/HTTP-Shortcuts
#
jacky
re: making bookmarks as a shortcut - this seems to be a bit like Apple's Shortcuts
#
Loqi
[Waboodoo] HTTP-Shortcuts: Android app to create home screen shortcuts that trigger arbitrary HTTP requests
mceldeen joined the channel
#
GWG
That's what I am using
mceldeen joined the channel
#
Zegnat
That looks *very* interestig
mceldeen joined the channel
#
GWG
jacky: I have been using it for some time for other things
mceldeen, jacky and ben_thatmustbeme joined the channel
#
[jgmac1106]
i use e-content, I am not summarizing the thing I am bookmarking, I may include a summary but I also add reflections, questions, etc
mceldeen, benji and sayanarijit[d] joined the channel
#
[KevinMarks]
Right, that makes sense too. Mark it up to clarify what you did.
ShinyCyril, mceldeen, angelo and capjamesg1 joined the channel
#
capjamesg1
Discord is down :(
mceldeen and jacky joined the channel
#
Seirdy
[schmarty]: hey, for some reason https://xn--sr8hvo.ws/ isn't picking up my site's profile information (https://seirdy.one) although it validates just fine on parsers like pin13.net
jacky joined the channel
#
Seirdy
and with extruct
#
[schmarty]
Seirdy: the webring follows the representative h-card parsing algorithm. http://microformats.org/wiki/representative-h-card-parsing
#
Seirdy
[schmarty]: ok, i added a u-uid and rel=me to mine; i'll check again when the CI job finishes
#
Seirdy
ayy it worked
#
Seirdy
thanks
#
[schmarty]
woohooo! welcome to the 🕸!!
#
Seirdy
ive been in the ring for a while just without a profile page
#
[schmarty]
haha oh right 🤦‍♂️
#
Seirdy
also lmao at my emoji identifier: 😩🚣🍑
#
[schmarty]
hahaaaa, yeah, i need to hurry up and deprecate those 😅
#
Seirdy
no keep mine
#
Seirdy
its perfect
#
[schmarty]
it was very much an IndieWebCamp hack day "haha, this will be hilarious" situation without time to think about the ✨consequences✨
#
[schmarty]
i don't have a timeline to make changes right now but my plan isn't to remove them so much as de-emphasize them from the directory and profile pages.
#
Seirdy
i'd say it's fine as long as you stick to the subset of emoji that doesn't involve crazy modifiers and extended graphemes.
#
Seirdy
tho maybe put a notice that they're subject to change at a later date, so nobody writes a script that uses them as a persistent identifier.
balupton[d] joined the channel
#
[schmarty]
so far i have been able to change things _about_ the identifiers without changing existing identifiers. that's why they're 3-emoji-long now. (first edition was 1 emoji, then 2, now 3. each time reducing the available emoji set to remove stuff like country flags, problematic stuff, etc.)
#
Seirdy
you could also just throw in ඞ for fun
#
[schmarty]
😂 today i learned
#
Seirdy
ඞඞඞඞ when the unicode is sus
#
Seirdy
does anyone here use buku for bookmarking
#
Seirdy
curious if im not the first to figure out a way to turn a buku database into an indieweb bookomarks h-feed.
#
Loqi
[jarun] buku: :bookmark: Personal mini-web in text
#
Seirdy
*bookmarks
#
Seirdy
esp. useful since it can import browser bookmarks
shaunix[d] joined the channel
#
Seirdy
currently using a horrible hack where the first tag in my buku db (alphabetically) is an rfc-3339 timestamp. now im figuring out the best way to cause a bookmarking to trigger a partial site rebuild on my local machine (not in CI), upload the changes, and POSSE to tinygem.org and maybe the fediverse.
#
jacky
css-variables++
#
Loqi
css-variables has 1 karma over the last year
#
jacky
it made me adding dark mode to my site really easy
#
[snarfed]
totally! mine too
#
Seirdy
jacky: I try to support browsers like NetSurf and Dillo, which means no CSS variables for me. tho i do use browser d efault styles for non-dark mode so adding dark mode was trivial
#
Seirdy
jacky: you might want to darken the footer on dark-mode too, and check your contrast levels with the advanced perceptual contrast algorithm (APCA); the latter is available in Chromium Devtools -> settings -> experiments -> check both APCA and the CSS Overview.
jacky joined the channel
#
Murray[d]
I wouldn't prioritise APCA just yet 😉 Has it even been peer-reviewed yet? *goes to check*
#
Loqi
[ericwbailey] #574 Clarify the methodology for verifying APCA’s efficacy
#
sknebel
that thread is an interesting mess
jacky joined the channel
#
jacky
Seirdy: I'm def down to try those browsers out
#
[KevinMarks]
APCA is a lot better than the current heuristic, which was measured crudely many years ago on entirely different kinds of screens and with a very different font rendering model than anything we use now
#
Murray[d]
I will be extremely happy if that turns out to be true, but I'm waiting for the verdicts 🙂
#
Zegnat
That definitely was some read ...
jacky joined the channel
#
Seirdy
Murray[d]: i've personally found it to be quite good and the existing contrast approach to be quite bad. esp. for me since i often use a screen in the sun.
#
Seirdy
jacky: netsurf is especially interesting, and the gtk interface is relatively straightforward to build. i currently use it in a single-tabbed mode in a bubblerwap sandbox, cuz it doesn't offer sandboxing of its own.
#
jacky
agh it defaults to _google_
#
Seirdy
jacky: are you building it or using a distro package? distro packages tend to be dated...
#
Seirdy
for NS at least
#
jacky
distro from elementary
#
jacky
wondering if there's a flatpak
#
jacky
oh yeah this is the latest it looks like
#
jacky
tbh it doesn't look bad but I would have to do some work to optimize it for this browser
#
Seirdy
yeah i always try to stick to a single-layout source-order-matches-presentation-order when I can, so i don't have to worry about grids and flexboxes and whatnot
#
Seirdy
s/single-layout/single-column/
#
Seirdy
cuz i use tiling windows; i frequently re-size windows to a fraction of their original size
#
jacky
ah gotcha
#
jacky
yeah I was in that space for a bit
#
jacky
i3 namely
#
Murray[d]
@Seirdy don't get me wrong, personally it _looks_ like a major improvement. I have several minor vision issues (all of which can be corrected, tbc) and it does seem to give better results to me. But until I see accessibility experts and disability advocates actually pushing it I'll continue deferring to WCAG 2. And until WCAG officially incorporates it, WCAG 2 remains the legal requirement, so I won't use it for client work either 😉 But I
#
Seirdy
so all those "responsive" layouts are really annoying on a tiling wm. like i re-size a window...wait where did everything to
oodani joined the channel
#
jacky
that's poorly implemented responsive design
#
jacky
it shouldn't cause content to be inaccessible or completely missing when resizing without some sort of affordance
#
jacky
from what I remember of the making's writing
#
Seirdy
jacky: you can't sandwich three columns together when you shrink the width; something has to move out of the viewport.
#
Seirdy
then if the user was reading it, they have to stop and go find it
#
Seirdy
right now i kinda work around that by doing ctrl-f and searching for a string if i remember it.
#
aaronpk
i think you might be an edge case here :)
#
aaronpk
something tells me tiling window managers are not used by a majority of users
#
Seirdy
there currently isn't a way for a web page to tell the browser "don't re-size me"
#
Seirdy
well maybe there is
#
Seirdy
aaronpk: it's not just tiling WMs, it's anyone who doesn't always browse full-screen. lots of people re-size windows.
#
jacky
I know that Firefox has a way to stay in "desktop mode" but I don't remember how that works
#
jacky
hmm mobile only tho
#
e-snail
> it's not just tiling WMs
#
e-snail
it's also when you just use the tiling features of a DE to snap a window to the side, etc
#
e-snail
Seirdy: I feel your pain on this one
#
Seirdy
cuz right now i'm not aware of a way for a web page to tell a browser "if i am re-sized then content is gonna move around a lot and the user will be annoyed, so pls just use horizontal scroll until the user presses a "reflow" button or something kthx"
#
jacky
might need some sort of userscript to force <html> to be like the screen's width or something
#
Seirdy
jacky: this is the kind of functionality that shouldn't require enabling JS