#dev 2017-07-25

2017-07-25 UTC
snarfed joined the channel
#
tantek
eternal struggle between actually using your site (writing content, replies, etc.)
#
tantek
and adding support to make it easier to do so, or show more responses etc.
KartikPrabhu joined the channel
#
tantek
(good indieweb problems / challenges to have)
#
GWG
I have that challenge all the time.
snarfed, snarfed1, [miklb], tantek, [chrisaldrich], eli_oat, Defenestrate, j12t, KartikPrabhu, cweiske and barpthewire joined the channel
#
www.boffosocko.com
edited /Indieweb_for_Education (+340) "article: A Domain of One's Own in a Post-Ownership Society"
(view diff)
#
loqi.me
edited /lobsters (+62) "/* See Also */ new section"
(view diff)
#
kodfabrik.se
edited /lobsters (+26) "Extending See Also section"
(view diff)
[kevinmarks] and j12t joined the channel
#
@markku
Interesting approach to online social discussions that isn't limited to a platform or technology. https://allinthehead.com/retro/378/implementing-webmentions
(twitter.com/_/status/889775868775616512)
j12t and [kevinmarks] joined the channel
#
petermolnar
!tell tantek re "zip in zip" 42.zip -> http://www.unforgettable.dk/
#
Loqi
Ok, I'll tell them that when I see them next
#
petermolnar
I've ended up alternating the cycles between creating content and adding new technical stuff
#
[kevinmarks]
Aaron can call his zip in zip structure a zipblockchain and get vc funding
#
petermolnar
I need some CSS help: apparently my footnotes link look different on Chrome, as they are not inline but number. [gap line] [link in next line] and I have no idea why
#
Zegnat
Looks the same to me Fx-vs-Chromium, petermolnar
#
petermolnar
linux shit then
#
petermolnar
thanks for checking
#
petermolnar
good. thanks
#
Zegnat
Left is Chromium (though I may be on a slightly older version than current stable), Right is Firefox (Developers Edition)
j12t joined the channel
#
sebsel
petermolnar Zegnat Chromium seems fine, but, sorry, Chrome not. https://seblog.nl/temp/media-endpoint/2e61b5-chrome.jpg
#
petermolnar
now that's interesting
#
sebsel
Safari on Mac is fine too. It looks like a Chrome bug then.
davidmead, j12t and KevinMarks joined the channel
#
loqi.me
created /indielogin.com (+367) "prompted by sebsel and dfn added by sebsel"
(view diff)
#
vanderven.se martijn
edited /IndieAuth (+669) "/* naming confusion */ Resolving the IndieAuth.com-is-a-service problem through renaming."
(view diff)
singpolyma, eli_oat and sebboh` joined the channel
#
voxpelli
Markdown over Micropub isn't really possible – right? One either transfer plain text or HTML and the plain text should be exactly that, not some kind of hidden format like Markdown – right?
#
voxpelli
If one were to transfer Markdown over Micropub, then one would really have to do it the same way as HTML is transferred, right? And explicitly define it as being Markdown?
#
aaronpk
voxpelli: you can send markdown as text in Micropub
#
aaronpk
then clients that edit the text will show it as plaintext
#
aaronpk
which, surprise, is the goal of markdown
#
voxpelli
aaronpk: but how do a server know that the client intended it to be markdown or plain text? an endpoint that treats all plain text as markdown will have a hard time with clients that doesn't send markdown'
#
voxpelli
I guess eg. OwnYourGram sends plain text – an endpoint that would support markdown in plain texts would then all of the sudden start parsing OwnYourGram notes as markdown then?
#
sknebel
yeah, if you want an endpoint that supports both plaintext and markdown as different formats you'll need to detect that somehow
#
sknebel
you could go by client_id to filter out special cases like OYG, if I remember right sebsel has some magic marker at the beginning
#
voxpelli
as markdown can require some text to be escaped to be presented correctly and that text will appear incorrectly if not sent through a Markdown processor it would be hard for a Micropub client to support both Markdown and non-Markdown endpoints with the same content
#
sknebel
I'll have to add something for HTML as well, since existing micropub clients are quite inflexible when it comes to posting HTML
#
sebsel
If the first line of my content starts with '# ', I remove it and make it the content of the name-field, yes.
#
sknebel
ah, ok, not formatting format. then we just talked about that at the river in Nürnberg ;)
#
sebsel
Ah, but I store all my stuff in Markdown
#
voxpelli
My decision was to convert my Markdown to HTML, send it as supported mark up over Micropub and then if I wanted to save it as Markdown in my endpoint as well, so that the data was always transfered in standard markup
#
sknebel
I have a draft of an Micropub extension for more formats flying around somewhere, but there was something I didn't find a good solution for
#
voxpelli
As I want to always store my stuff as Markdown I needed to do that conversion for clients like Quill anyway
#
sknebel
I think it was "how can a client querying post content indicate it supports said extension"
#
voxpelli
sknebel: yeah, that would be key
#
voxpelli
I'm also not sure what the strict advantage would be to support alternative markup languages over Micropub – wouldn't it just be better if everyone used HTML?
#
voxpelli
sebsel: so if you connect to OwnYourGram and add a typical Instagram post that's just hashtags all over, then you will get a somewhat unexpected result ;)
#
sknebel
If my backend storage format isn't HTML I wouldn't want to convert that to HTML and back just to get it through MP
#
voxpelli
sure, if both you and a micropub client both support markdown, then that wouldn't be necessary, but you would still need to do it if you would want to support clients that save HTML-content, right?
#
sebsel
voxpelli I don't use OwnYourGram, but had the problem with import, yeah. For the script I only check "#<space>", not just "#". And I have a pre-markdown filter, which converts hashtags to links (and categories), so I don't have the problem anymore.
#
sknebel
voxpelli: yeah, but I'd also want to be able edit my storage format directly
#
sknebel
otherwise, I'd just use HTML as the storage format
#
sknebel
(which indeed is something my site can do, and I use for posts where I want markup I currently can't generate)
j12t joined the channel
#
voxpelli
sebsel: I guess that works as some kind of hack :/
#
voxpelli
I was triggered by this discussion with Manton and his thoughts on moving to a 100% Markdown Micropub + escaping HTML: https://twitter.com/voxpelli/status/889840961265827840
#
@voxpelli
@manton2 But how will you be able to transfer Markdown over Micropub? Micropub data is either plain text or HTML? How will you indicate its Markdown?
(twitter.com/_/status/889840961265827840)
#
voxpelli
Feels like something there should be a best practice on
#
voxpelli
Feels like eg. Manton would have actually preferred to disallow HTML altogether and just allow Markdown
#
sknebel
current state (I think) is "Markdown is a plaintext format, a client that just can edit any plaintext can edit markdown, if you want to make a markdown specific client take care to only use it with endpoints that do markdown when you give them plain tex"
#
voxpelli
Without https://indieweb.org/Micropub-brainstorming#Provide_end-use there is also no way to deliver any error message telling a user that eg. they are not allowed to add table tags or such
#
sebsel
what is markdown?
#
Loqi
Markdown is a way of writing and interpreting plain text so that it can optionally be converted to more explicitly meaningful or richly styled text (e.g https://indieweb.org/markdown
#
voxpelli
sknebel: but that means that either an endpoint will have to treat everything as markdown or nothing as markdown and that will, if markdown gets popular, that all clients will have to expect their plain text to be handled as markdown
#
aaronpk
Also just keep in mind your backend doesn't have to store everything the same. My posts are stored in either plaintext, markdown, or HTML, and there's a property on the post that indicates the content type
#
sknebel
voxpelli: yes. not saying that I think that's good, just that that seems to be the state of things
#
sknebel
aaronpk: since that was where I got stuck, is there a decided way to indicate support for micropub extensions in queries? when posting I can check the query-endpoint for a special value to discover server support and then use an mp-… property, but while querying?
#
aaronpk
also the thing about markdown... there is like 5 versions. So how do you indicate which markdown parser the server supports?
#
sknebel
(and: can mp-properties be queried?)
#
sknebel
(or are they strictly "commands")
#
aaronpk
sknebel: we need to experiment more with the query stuff
#
sknebel
I'm kind of down on micropub right now, but I could just try to implement my concept
#
sknebel
(although I mostly implemented MP to avoid having to write clients, but since that didn't pan out anyways...)
#
voxpelli
aaronpk: but how do you know when to save somethingas plain text or markdown if it's not indicated – how do you know when a "*" is meant to be interpreted as Markdown or not?
#
voxpelli
(if one would standardize support it would probably make sense to standardize on CommonMark as Common Mark tried to standardize all the different Markdown variants)
#
voxpelli
One example of where it becomes important to know whether somethings is Markdown or not is when posting code snippets as plain text. As proven by eg: https://meta.stackexchange.com/questions/82718/how-do-i-escape-a-backtick-in-markdown
#
voxpelli
Code snippets can often have patterns in them that can be interpreted as Markdown
#
voxpelli
So if I always interpret plain text as markdown and then try to post a code snippet as a note in Quill I will get something very unexpected at my site unless Quill escapes the code so that it's Markdown compatible
[aaronpk] joined the channel
#
[aaronpk]
I was just saying that you don't have to convert everything to the same format when you store it
#
[aaronpk]
Do you have a situation where you want to use a Micropub client that understands markdown right now?
#
voxpelli
aaronpk: the case was that Manton was thinking about moving all of the Micro.blog stuff to Markdown
#
voxpelli
And I want to ensure my endpoint works with his client, but then I need to know if I'm sent Markdown or not
#
[aaronpk]
I haven't actually found it necessary yet, I either post text notes or HTML from quill and if I'm writing a markdown post I usually am writing it by hand in my storage
#
loqi.me
created /IndieWebCamp_Dortmund (+66) "prompted by sknebel and dfn added by sknebel"
(view diff)
#
voxpelli
Manton apparently wants to move away from HTML: http://www.manton.org/2017/07/micro-blog-photos-from-marsedit.html Which I guess makes sense for a microblog
#
voxpelli
> After the next version of the Micro.blog iOS app ships, Micro.blog will start requiring Markdown and escaping HTML tags from Micropub, just as it currently does from the web interface.
#
voxpelli
If that's where he wants to go I'm failing at pointing him in a good direction – I don't think plainly sending markdown as plain text is a good long term solution
#
[aaronpk]
I wonder
#
voxpelli
Would love to be able to give him a solution like sknebel's if he feels he wants to enforce Markdown
#
[aaronpk]
Do you know if he's actually using the HTML feature of Micropub or is he incorrectly not currently escaping HTML tags sent in Micropub plaintext requests?
#
voxpelli
Hmm, I haven't tried posting to my Micro.blog endpoint, just tried from Micro.blog to my endpoint
#
[aaronpk]
Oops the Micro.blog app apparently doesn't send replies via Micropub
#
voxpelli
Neither does it send favorites
#
[aaronpk]
I haven't actually looked at the raw request it sends, does it send HTML or text?
snarfed joined the channel
#
voxpelli
I haven't looked either, but I think it's just text from the app – there are no formatting possibilities at all there (apart from maybe Markdown)
#
aaronpk
If that's the case then he should have been escaping HTML from the beginning and this is just a bug fix
#
voxpelli
totally
#
voxpelli
it do highlight the fact that one may want to indicate to eg. Quill that one doesn't support HTML at all and/or be able to communicate to Quill when an unsupported HTML-feature is used
#
voxpelli
because right now if one is sent html-content, there's really no good way to respond if one doesn't want to accept that content?
#
[aaronpk]
Yeah, we haven't really done much feature detection in micropub yet
#
[aaronpk]
Other than media endpoint
#
[aaronpk]
Yeah the only response there would be "bad request"
#
voxpelli
and actually be preferable I think – if one could whitelist eg. links, bold, italic but communicate that everything else if forbidden, then that should work for most scenarios
#
[aaronpk]
That's certainly worth some experimentation
#
sknebel
I'll try to find notes again and post them somewhere, they should at least be a basis for discussion
#
sknebel
24 hours until sknebel, did you find your MP content type notes?
#
Loqi
I added a countdown scheduled for 2017-07-26 4:35pm CEST (#6057)
#
[aaronpk]
The trick with the capability indicator is id want that to be optional and an upgrade thing, so that someone building a server doesn't have to build that just to get going
#
voxpelli
adding a "formats" to the query would go pretty far
#
voxpelli
one problem I noticed is that in https://www.w3.org/TR/micropub/#html-content it says that unless the content is HTML a string should always be returned, and in the case of eg. markdown or some other data extension (like languages which we have talked about) it would still have to be an object
#
voxpelli
being able to return eg. "content": {"value": "Ett exempel på svenska", "lang": "sv_SE"} would be good for the extensibility
#
voxpelli
likewise "content": {"markdown": "**awesome**"} if that would be the format of a possible markdown extension
#
sknebel
my idea was to extend that pattern and just do "content": {"CommonMark":"…"} or something
#
sknebel
q endpoint to discover server support and a list of supported formats
#
[aaronpk]
Ooh that probably should have said the other way around
#
[aaronpk]
cringes at the CamelCase
#
voxpelli
sknebel: one could probably make that two different extensions: One for disocvering new formats and one for defining one new such format
#
voxpelli
yeah, I would skip CamelCase
#
sknebel
bikesheds...
#
petermolnar
camelCase, no? :P
#
sknebel
and for querying the question is how to indicate support in the query. if mp-… can be used as a command for queries it could just be an added mp-<magic word>=true
#
sknebel
voxpelli: yes, I only thought about a general way of doing it and offering a list, since I'd be fine with just a dropdown on the client to choose how my text is interpreted serverside. then defining a specific name to use for e.g. commonmark is just a tiny extra piece
#
[aaronpk]
I'd think that would be part of the q=config response
#
voxpelli
sknebel: I'm thinking that in ?q=config one returns "formats": ["commonmark"]
#
sknebel
yes, something like that
#
voxpelli
adding to ?q=config is extra simple in my endpoint
#
sknebel
(I actually had an object with id and a description text, and I think I put it in a an extra ?q=, but thats details)
#
voxpelli
sknebel: I'm thinking that commonmark won't be a custom format that needs any description text etc but rather a standardized format that all who supports it already knows what it is
#
sknebel
but I'd want to support custom formats
#
sknebel
so everything gets an id and a text and people then can say "ok, we will always give commonmark the id "commonmark" and that's commonmark support standardized
#
voxpelli
Unless you want it to also support fully custom formats, like me doing a VoxPelliScript for my posts and me wanting to expose that custom format to Quill etc, then any possible future format could just do the same thing as commonmark does and everyone supporting that would know what it is as well
#
sknebel
sorry, don't understand what you mean
j12t joined the channel
#
voxpelli
commonmark isn't really a fully custom format, a fully custom format would be if I define a format for myself
[miklb] joined the channel
#
[miklb]
I’m trying to follow the discussion, but not following why need to communicate what flavor of plaintext is being passed
#
[aaronpk]
miklb mostly because of escaping text
#
sknebel
voxpelli: of course, but that doesn't matter IMHO. point is, I'd want to have a description text for fully custom formats, and commonmark then can just a be speical case of that
#
voxpelli
[miklb]: yeah, server needs to know it is safe to parse the text as markdown or not
[chrisaldrich] joined the channel
#
voxpelli
sknebel: I'm not sure there's a need for that :/
#
voxpelli
and if there's a need for that, what that need would look like
#
[miklb]
hmm. So [this idea](https://example.com) needs to be treated differently than [thought] https://example.com (idea)
#
voxpelli
[miklb]: Ever accidentally posted a code snippet into a markdown-supporting textarea without escaping it? :P
#
sknebel
[miklb]: more like is "#indieweb" a markdown headline or a #hashtag?
#
[miklb]
what flavor of markdown parses #indieweb as <h1>indieweb</h1> ?
#
sknebel
voxpelli: well, I don't care about commonmark and want custom formats with a note what they exactly were, so that's why I choose that design. one could of course say "if it'sjust a string, that's the id" and thus allow giving just well-known ids instead
#
[aaronpk]
When it's on its own line, all of them?
#
voxpelli
sknebel: yeah, sounded like we were proposing the same thing initially, but now I see that we aren't so we have two different use cases to solve and then maybe two different designs that needs dogfooding and proof :)
#
[aaronpk]
Hm I didn't think space was required but I could be wrong
#
sknebel
voxpelli: I don't see how "adding an optional info text" is such a big difference ;)
#
voxpelli
sknebel: well, your use case is: Support arbitrary custom format. The use case I brought up from Manton is: Support Markdown
#
[aaronpk]
voxpelli: we originally had just a string for syndicate-to and then changed it to id/name because we realized clients would want to show more friendly text
#
voxpelli
sknebel: you want to be able to select a format in an editor, I just wants a client to know whether it can send markdown to an endpoint or not and react to that however it choses
#
sknebel
so don't show the list if your a pure markdown editor
#
voxpelli
[aaronpk]: yeah, that makes sense when the values are fully custom
#
voxpelli
sknebel: HTML is already supported as an explicit format, no reason markdown can't as well, and no reason custom formats can't be supported if markdown is supported explicitly as wlel, so they can both be proven and implemented individually
#
sknebel
but the shared problem space is so large that I don't see much point in treating them differently
tantek joined the channel
#
voxpelli
sknebel: I would be very hesitant to support custom formats as top level keys, so that eg. a "formats": ["random-id"] would be used as: "content": {"random-id": "value"}, as the values of an object can be extended by other extensions – adding eg. language support etc
#
voxpelli
sknebel: so then the design would have to be something like "content": {"value": "text", "format": "random-id"}, and that looks much more verbose than "content": {"markdown": "text"}
#
voxpelli
if the key in the content object should be a top level key, then it should be standardized and documented so that other extensions can know whether its reasonable to expect a conflict with an existing name or not. Arbitrary keys should not be put in there, such values should be limited to values
#
sknebel
interesting point
#
sknebel
, but that difference honestly looks totally trivial to me
#
voxpelli
to me it doesn't as it shows how the custom formats are a more complex solution than just standardizing markdown/commonmark as a new format on the same level of the existing html format + to define a mechanism for discovering which such formats athat are supported
#
sknebel
but custom formats also is just a mechanism to discovering which formats are supported and then sending some indication which of those formats you want?
#
voxpelli
not if its meant to support arbitrary formats, then its something else
#
voxpelli
guesses that actually this should really be rooted in the microformat data model as that's where the Micropub model comes from
#
sknebel
why? your swapping a central registry (micropub extensions describing which values are allowed) for a server-given list, that's all
#
sknebel
and if you say that saying "format":"markdown" isntead of "markdown":"text" is noticably "more complex" then I guess we just have to disagree on that
#
sknebel
(I'd probably be fine with putting the arbitrary keys in the content object, if a server operator creates a conflict with another extension there that's their problem and one they can easily solve
#
voxpelli
sknebel: one maps to the existing style of html, the other constructs a new style, and such a new style needs to have a reason for it, and I'm just saying that proving and dogfooding that can be separate from finding a solution to supporting markdown
#
voxpelli
sknebel: allowing arbitrary keys in an object conflicts with the idea of extensibility
#
sknebel
since new keys can only happen there if a server supports it, and the server is the authority on the list I think it'd be tolerable, but agreed that avoiding it is better
#
voxpelli
it only requires one client and server do start using it for it to become a problem
#
voxpelli
I mean: The javascript standard had to change contains() to includes() for checking a value in an array just because Mootools or something had claimed contains() way back, so compatibility would break with all those sites otherwise
#
petermolnar
I'm just going to stick to markdown features Pandoc supports
#
petermolnar
not even to all of them
#
sknebel
it only becomes a problem if said server wants to support a conflicting extension as well, and then they'll can easily rename their special format if it's really just one server. and if its more than one they totally should "reserve" that name as a "micropub extension"
#
sknebel
but again, not against putting it in a value instead
#
voxpelli
Both suggestions has merits and both needs to get implementations and traction and if custom formats gain traction in such a way that it makes sense for markdown to use it, then great, otherwise it feels like the markdown case on it own isn't enough to justify a full custom formats feature
#
voxpelli
Both should be documented as brainstorms though
#
sknebel
and if people work out different ways of doing markdown and doing custom formats, now everyone who wants to support both (clients and servers) has to handle both cases
#
voxpelli
+ ensure that any discovery mechanism doesn't conflict between the two
#
sknebel
and given how even HTML isn't supported very widely I don't think that'd be good
#
voxpelli
Wouldn't be the first time there are many ways to achieve the same thing in the IndieWeb world ;) Plurality has its ups and downs
#
voxpelli
[aaronpk]: is it too late to open Micropub issues at GitHub? I'm thinking regarding that https://www.w3.org/TR/micropub/#html-content wording of "MUST be a string"
#
aaronpk
well it's too late to publish normative changes, but it's never too late to publish errata
#
sknebel
[miklb]: regarding headlines, commonmark indeed insists on the space, but e.g. the online demo on grubers site doesn't
#
aaronpk
i'd say go ahead and open the issue, and luckily we have a call in 90 minutes and i can ask about the process
#
[miklb]
sknebel good to know. I guess I’ve just been writing it for so long I assume **my** way is the one true way™ ?
#
sknebel
[miklb]: one of the problems with just using the label "markdown" ;) but yeah, I also had to check to make sure
#
[miklb]
notes that Slack doesn’t use `**bold**` and `*italic*`
tantek joined the channel
#
tantek
miklb `**bold**` and `*italic*` is one of the dumbest things in markdwon, because nearly no one did that in plain text before it got added to markdown, violating the first principle of markdown
#
Loqi
tantek: petermolnar left you a message 6 hours, 4 minutes ago: re "zip in zip" 42.zip -> http://www.unforgettable.dk/
#
tantek
lol, if you have to give a separate id or "type" for Markdown "content" then your markdown has failed. it's supposed to "just work" as plain text
#
aaronpk
it's a losing battle to go on a rant against markdown
#
tantek
that's what they said about XML
#
aaronpk
doesn't matter what its original goal was, it's become a Thing and people are using it
#
kodfabrik.se
edited /Micropub-brainstorming (+1717) "Adding initial brainstorm about additional data formats"
(view diff)
#
Loqi
[sknebel] [miklb]: regarding headlines, commonmark indeed insists on the space, but e.g. the online demo on grubers site doesn't
#
singpolyma
markdown is what I turn HTML emails back into so I can read them. works about 60% of the time (when there aren't tables-in-tables-in-tables for layout in the html)
#
tantek
it's squishy enough (frustrating enough) of a "thing" to be displaced in just one generation (~5 years) of developer turnover
#
tantek
whoa this is one of the nicest looking facepile examples yet! https://allinthehead.com/retro/378/implementing-webmentions#comments
#
tantek
drewinthehead++
#
Loqi
drewinthehead has 3 karma
#
voxpelli
sknebel: please please edit that wiki page – I'm not sure if I did your suggestion justice, I very much hope so
#
[miklb]
tantek, your opinion of markdown is well known, I do not need another lecture
#
Loqi
[voxpelli] #101 Should string really be a MUST for non-HTML content?
#
sknebel
(pretty sure the ** and * were in reStructuredText as well, and I think even it's predecessor Structured Text. but yes, no need to reheat that particular discussion)
#
voxpelli
tantek: the issue isn't that Markdown doesn't work as text, the issue is that text doesn't necessarily work as Markdown, so you need to be sure that someone doesn't interpret something as Markdown when they are not intended to :/
#
voxpelli
sknebel: are you editing? otherwise I'll throw in a pointer to that GitHub issue
#
sknebel
voxpelli: go ahead
#
[aaronpk]
That's... an interesting choice
#
aaronpk
i sent that from slack like an hour ago
tantek and j12t joined the channel
#
[aaronpk]
I wonder
#
kodfabrik.se
edited /Micropub-brainstorming (+164) "/* Additional data formats */ Adding note about possible specification issues"
(view diff)
#
aaronpk
how many of my messages didn't come through at first? and why??
#
tantek
miklb lol fair. I'm postponing the greater markdown battle for now, more important things to build first. In the mean time I'll just keep replacing my own need for md with an ever enhanced autolinker
#
[aaronpk]
I haven't actually looked at the raw request it sends, does it send HTML or text?
#
voxpelli
tantek: maybe you can note or reference some criticism here though: https://indieweb.org/Micropub-brainstorming#Additional_data_formats ?
#
tantek
uh voxpelli aaronpk that /Micropub-brainstorming is kind of a mess
#
aaronpk
huh? I haven't looked yet
#
voxpelli
tantek: the page as a whole? I just found it and felt that was the correct place to but a brainstorm, haven't really looked at the other stuff there
#
tantek
even the very top of the page has very little context for it, then code examples that overlap the toc
#
tantek
voxpelli: no I mean just load the page from the top and start reading. besides the overlapping text, it just immediately deep dives into very detailed issues without any overview
#
tantek
since I don't know (can't understand) the purpose of the page, I'm not sure how to "fix" it
#
voxpelli
tantek: yeah, feels like some suggestions was moved over there to be able to close down issues in GitHub, like eg. my user-facing error ones, could be that it was done in a hurry and then haven't gotten a makeover
#
www.svenknebel.de
edited /Micropub-brainstorming (+311) "/* Possible specification issues */ mp-… properties while querying source?"
(view diff)
#
aaronpk
looks like in 2014 that page was created by moving content out of /Micropub
#
aaronpk
so... this is not a new problem ;-)
#
tantek
ok so it started as a dumping ground of sorts
#
tantek
aaronpk that first version is much more readable
#
tantek
so it's gotten much worse
#
sknebel
I went through a few months back and sorted out hte resolved issues
#
tantek
SMH wow overdesign generalized from the internal corruption of a single meta-format https://indieweb.org/Micropub-brainstorming#Additional_data_formats
#
[aaronpk]
That's certainly worth some experimentation
#
kodfabrik.se
edited /Micropub-brainstorming (+115) "/* See more */ Adding link to post about Micro.blog + Markdown"
(view diff)
#
tantek
aaronpk I'm still confused by what problem is being solved by explicitly typing commonmark, rather than just, on your server, treating your "plain text" as markdown
#
aaronpk
you can't treat plaintext as markdown and vice versa
#
tantek
ok I see: "else some types of content – like code snippets – will easily get misinterpreted. "
#
tantek
would appreciate actual examples of this happening
#
aaronpk
same problem with trying to treat html as plaintext, some characters have special meaning
#
tantek
except HTML was never designed to be "just plain text, upgraded"
#
tantek
whereas markdown was
#
aaronpk
markdown started as that, and has changed
#
tantek
is there a name for that "started as that" version?
#
aaronpk
so you can't treat every case where it's no longer the case that markdown fails as plaintext as an error
#
tantek
before it went all haywire perl-like?
#
aaronpk
because that's not how it's used anymore
KevinMarks joined the channel
#
tantek
what's the name for the before vs "current" / "how it's used now" versions?
#
tantek
since clearly they've got quite different design goals
#
tantek
conceptually a sharp fork
#
voxpelli
I'll add an example of plain text that will be interpreted wrongly as CommonMark
#
tantek
voxpelli: I don't care for artificially constructed examples. those are always possible for nearly any spec / standard
#
tantek
curious if you have any real world examples to cite / quote
#
[miklb]
lol “I’m postponing the greater markdown battle for now”
#
tantek
also, "design by artificial edge case" is totally an anti-pattern I need to add to my queue
#
voxpelli
tantek: I'll add a real example :)
#
tantek
miklb, many battles can be won by picking the time and place
#
[miklb]
agreed, just seems like you aren’t letting it go ?
#
sknebel
makes a note to keep brainstorming to private channels in the future
#
tantek
miklb, correct. i'm stockpiling first by enhancing autolinker
#
tantek
sknebel, it's good to have disagreements about brainstorming, that's part of the point, especially in doing it openly
#
[miklb]
what is autolinker
#
Loqi
It looks like we don't have a page for "autolinker" yet. Would you like to create it?
#
tantek
doesn't mean deleting it or not talking about it, but rather, trying to capture multiple perspectives to better understand the space
#
tantek
what is autolink
#
Loqi
An autolink is a hyperlink that was automatically added to some text to link that text to an obvious or useful destination, like hyperlinking a URL in plaintext to the URL itself, linking hashtags to search results, and @-names to their profile pages https://indieweb.org/autolink
#
sknebel
you're "disagreement" reads like "your stupid for having a usecase I don't understand" to me, sorry
#
tantek
what is autoembed
#
Loqi
An autoembed is an embedding of media, typically of an image or video, that was automatically added from a URL to that media, to provide immediate viewing and or direct interaction with that media https://indieweb.org/autoembed
#
sknebel
*you're
gRegorLove joined the channel
#
tantek
sknebel, it's informal chat, and why I didn't put it in the wiki like that
#
kodfabrik.se
edited /Micropub-brainstorming (+375) "/* Additional data formats */ Adding plain text example that will be misinterpreted by CommonMark"
(view diff)
#
voxpelli
I think most developers who have ever forgot to escape a piece of code when writing Markdown can relate to that example, so it's very much real
#
tantek
definitely no personal offense stated nor intended. if anything sounds dismissive, it's about the ideas, not the authors thereof
#
aaronpk
lol that sounds like one of those twitter bio disclaimers
#
tantek
voxpelli: like when trying to put HTML examples in a github comment and having them disappear?
#
aaronpk
"opinions my own, not of my employer"
#
aaronpk
"if anything sounds dismissive, it's about the ideas, not the authors thereof"
#
tantek
lol aaronpk touché
#
voxpelli
tantek: exactly
#
voxpelli
One criticism I can have against additional formats is that it makes Micropub diverge from MF2, those should maybe be documented
#
tantek
voxpelli happens to me in like ~50% of my github comments (seriously) and it just makes me that much more critical of markdown and wanting to avoid ever depending on it
#
aaronpk
oh yeah you have to escape HTML with backticks on github
#
aaronpk
cause HTML is allowed in markdown
#
aaronpk
except on github where it strips it :P
#
tantek
perhaps that was one of the big errors when markdown diverged from its roots - allowing (encouraging!) raw html
#
voxpelli
tantek: totally, this issue is mainly about avoiding Markdown becoming the unofficial standard of plain text data in Micropub by making support for it explicit rather than implicit
#
tantek
voxpelli: interesting reframing. ok will have to think about that to come up with an updated opinion
#
tantek
voxpelli: hence I think my request for the names of markdown
#
voxpelli
tantek: as it was triggered by Micro.blog thinking about moving to 100% Markdown and me then thinking that wow, this will cause issues when using it with eg. Quill to send notes such as in that example
#
tantek
aaronpk said "markdown started as that, and has changed" - and I feel like we really need to name those two differently so we can talk about them specifically rather than the whole family history of markdown
#
tantek
and if someone else doesn't name them, then I will (promise, not threat)
#
aaronpk
John Gruber's Markdown is the original one right?
#
voxpelli
Totally
#
voxpelli
That's why CommonMark doesn't have Markdown in its name, because Gruber pretty much claimed copyright
#
voxpelli
Or the right to the name "Markdown" in some way
#
[miklb]
then came Fortin’s markdown extras I believe
#
tantek
re-reads Gruber's INTRODUCTION to Markdown, cries at what has been lost
#
tantek
takes a break
#
[miklb]
I feel the exact same way about HTML
snarfed joined the channel
#
kodfabrik.se
edited /Micropub-brainstorming (+92) "/* Additional data formats */ Restructure + add criticism section to encourage documentation of criticism against additional data formats"
(view diff)
#
aaronparecki.com
edited /Micropub-brainstorming (+152) "/* Criticism */"
(view diff)
#
[miklb]
I thought you needed a space
#
kodfabrik.se
edited /Micropub-brainstorming (+201) "/* Criticism */ Note it may make the threshold for entry higher for new participants"
(view diff)
KartikPrabhu joined the channel
#
aaronpk
wat. that message from [miklb] is also from a long time ago, around the same time as my old one came through
#
aaronpk
everything is broken ?
#
voxpelli
:/ Wonder what lags, Slack or the sync service
#
aaronpk
i think it's slack, i see it in the logs as a new message
#
aaronpk
the gateway is all web hook based, so i bet they had a slight lag with their web hooks around then
[chrisaldrich], barpthewire and [kevinmarks] joined the channel
#
[kevinmarks]
the other half of og markdown was aaronsw's html2text http://www.aaronsw.com/2002/html2text/
#
[kevinmarks]
so you could round trip
#
voxpelli
does round tripping in his endpoint
#
tantek
reads backlog
#
[kevinmarks]
if manton is going to converge on a variant he should pick one and name it accordingly. Using commonmark makes sense to me, as it is not specified to be ambiguous, unlike Gruberian markdown.
#
tantek
miklb, I am particularly interested in your opinions of HTML, and especially in the context of "what has been lost". We may have more in common there than not. I have long term "HTML: The Good Parts" (book) draft I'm working on.
#
tantek
considers submitting patches to html2text to add mf2 parsing and emojis for people, events, etc.
#
tantek
emoji in the "text" output as it were
#
[kevinmarks]
not sure who would check the PRs https://github.com/aaronsw/html2text
#
Loqi
[aaronsw] html2text: Convert HTML to Markdown-formatted text.
#
voxpelli
GitHub should do something about that :/
#
snarfed
i've had a mostly good experience with it. happy to answer q's
eli_oat joined the channel
#
[kevinmarks]
what is html2text?
#
Loqi
It looks like we don't have a page for "html2text" yet. Would you like to create it?
j12t joined the channel
#
[kevinmarks]
html2text is a codebase that converts HTML to markdown formatted text. [http://www.aaronsw.com/2002/html2text/ Originally by Aaron Swartz], it is now part of pypi and a [https://github.com/Alir3z4/html2text/ fork] is maintained.
#
loqi.me
created /html2text (+255) "prompted by [kevinmarks] and dfn added by [kevinmarks]"
(view diff)
#
[kevinmarks]
html2text << markdown
#
Loqi
ok, I added "[[markdown]]" to the "See Also" section of /html2text
#
loqi.me
edited /html2text (+32) "/* See Also */ new section"
(view diff)
#
[kevinmarks]
markdown << html2text
#
Loqi
ok, I added "[[html2text]]" to the "See Also" section of /markdown
#
loqi.me
edited /markdown (+16) "[kevinmarks] added "[[html2text]]" to "See Also""
(view diff)
snarfed and [jeremycherfas] joined the channel
#
dgold
in a json-encoded micropub payload, would bookmark-of be a value inside the 'properties' array
#
dgold
just trying to wrap my head around making nanopub json-capable
[grantcodes] joined the channel
#
[grantcodes]
what is nanopub?
#
Loqi
It looks like we don't have a page for "nanopub" yet. Would you like to create it?
[miklb], j12t, eli_oat and KevinMarks joined the channel
#
ascraeus.org
created /nanopub (+164) "Created page with "[https://github.com/dg01d/nanopub Nanopub] is a micropub server for use in static blog engines, written by [https://indieweb.org/User:Ascraeus.org Daniel Goldsmith]""
(view diff)
#
tantek
dgold++ very cool
#
Loqi
dgold has 2 karma in this channel (18 overall)
#
gregorlove.com
edited /Loqi (-5) "mv idea from see also"
(view diff)
tbbrown joined the channel
#
tantek.com
edited /Loqi (+274) "/* Ideas */ iterate on gregorlove's suggestion"
(view diff)
#
sknebel
do we have a Python micropub client?
KartikPrabhu joined the channel
#
loqi.me
created /Discoverability (+121) "prompted by sebsel and dfn added by sebsel"
(view diff)
#
loqi.me
edited /Discoverability (+37) "/* See Also */ new section"
(view diff)
#
loqi.me
edited /Discoverability (+28) "sebsel added "[[recommendation engine]]" to "See Also""
(view diff)
snarfed joined the channel
#
Zegnat
Wow. That was a huge backscroll. Did someone file an issue on the micropub spec repo?
tantek joined the channel
#
Loqi
[voxpelli] #101 Should string really be a MUST for non-HTML content?
#
Zegnat
Thanks
#
Zegnat
is taking a break from battling elemental oozes by reading micropub discussion
#
tantek.com
edited /Loqi (+550) "IndieWeb x Loqi Dominate the Day"
(view diff)
#
www.svenknebel.de
edited /Micropub-brainstorming (+0) "/* Possible specification issues */ swap url parts for clarity"
(view diff)
#
tantek.com
edited /issue_tracker (+328) "Discourage antipatterns"
(view diff)
#
loqi.me
created /yak_shaving (+38) "prompted by tantek and dfn added by tantek"
(view diff)
#
loqi.me
created /yak (+38) "prompted by tantek and dfn added by tantek"
(view diff)
#
loqi.me
edited /lulz (+20) "tantek added "[[issue tracker]]" to "See Also""
(view diff)
#
tantek.com
edited /lulz (-10) "FTFY Loqi"
(view diff)
#
dgold
haha (i think)
#
Loqi
ahahaha
#
dgold
_now_ i realise that Hugo accepts json as front-matter
#
@molovo
I’m about to tweet a post to test webmentions. I’d appreciate a few likes/retweets/replies so I can make sure they work. Thanks folks
(twitter.com/_/status/889935695900442624)
snarfed and [kevinmarks] joined the channel
#
[kevinmarks]
Hugo is flexible that way. 3 flavours of front matter
#
dgold
[kevinmarks]: aye, but for some reason back when I first looked at it, I completely missed that it can accept json
#
dgold
it makes my micropub-thing, sigh, magnitudes easier?
#
[kevinmarks]
Oh, I bet
#
[kevinmarks]
I wish the Hugo field names were the same as micropub though. Maybe they would take an extension.
#
dgold
now I just need to remember how to add to arrays in php... <mind hurty>
#
@molovo
I’m about to tweet a link to test webmentions, and I’d appreciate some likes/retweets/replies to test them. Thanks in advance folks
(twitter.com/_/status/889939805307641860)
#
Zegnat
$array[] = 'add this'
#
dgold
$foo = array(…)
#
dgold
if($cond) { $foo['bar'] = …
#
dgold
need conditionals Zegnat
#
Zegnat
if (true) { $array['key'] = 'value'; }
#
Zegnat
If you don’t have keys but just an array you can do the empty key thing []
#
tantek
dgold, I need to learn enough about arrays in PHP to find all the common syntax between ararys in PHP and arrays in JS
#
tantek
I have some array support in cassis.js but I want to add more
#
@DavidDarnes
Interested to see if @molovo can get webmentions working on his Jekyll site, testing by sharing this! https://molovo.co/writing/getting-it-wrong/
(twitter.com/_/status/889941754115485701)
#
[kevinmarks]
The tricky part is that php arrays and dictionaries are the same thing, but they're distinct in javascript
#
[kevinmarks]
There is some code in xoxolib.php that might help
#
tantek
not tricky, the distinction wins
#
[kevinmarks]
First function
#
Zegnat
Dictionaries:
#
Zegnat
PHP: ["key" => "value", "key" => "value"] (called array in PHP)
#
Zegnat
JS: {"key": "value", "key": "value"} (called object in JS)
#
Zegnat
Though almost all array actions can be done through functions in PHP, so those functions can be ported to JS easy enough
#
tantek
what is COOLPOSSE?
#
Loqi
It looks like we don't have a page for "COOLPOSSE" yet. Would you like to create it?
#
tantek
nah after two years I think I can do better
snarfed joined the channel
#
tantek.com
edited /Loqi (+965) "/* IndieWeb x Loqi Dominate the Day */ add responses for a few"
(view diff)
[chrisaldrich], snarfed, KevinMarks, KartikPrabhu and [cleverdevil] joined the channel
#
loqi.me
created /silomention (+21) "prompted by sebsel and dfn added by tantek"
(view diff)
snarfed, tantek, davidmead and KevinMarks_ joined the channel
#
tantek
voxpelli++ for reaching out and engaging positively / productively with https://twitter.com/voxpelli/status/889755727371190272 and thread
#
Loqi
voxpelli has 8 karma in this channel (105 overall)
#
@voxpelli
@manton2 Markdown over Micropub? I've been doing Markdown in my Micropub client + endpoint, but I do transfer it as HTML, would feel wrong otherwise?
(twitter.com/_/status/889755727371190272)
#
tantek
hmm - would be good to add more examples to http://indieweb.org/facepile especially now that we have the pretty ones like https://allinthehead.com/retro/378/implementing-webmentions#comments
#
tantek
and at least an interesting re-doing if not pretty per se: http://tantek.com/2017/207/e1/homebrew-website-club (showing more information than the FB equivalent)
#
Loqi
Homebrew Website Club SF
[miklb] joined the channel
#
[miklb]
I should add WP site to that page
#
Loqi
it is probable
#
[miklb]
having scores of likes & retweets though makes a dramatic difference
#
[miklb]
s/retweet/reposts/
leg, davidmead and Defenestrate joined the channel