jesse_the_k: text: Be kinder than need be: everyone is fighting some kind of battle (Default)

[sticky entry] Sticky: Overview of what's here


Sometimes the "@user.sitename.tld" shortcuts don’t work as expected.

The bugs are slightly different with plain text/HTML vs Markdown. Markdown-coded posts are tagged.

I've tested the issue with all 61 versions of the shortcuts listed here:

https://www.dreamwidth.org/support/faqbrowse?faqid=87

For simplicity's sake, in this comm I demonstrated the bugs with the four variants of the AO3:

\@user.archiveofourown.org
\@user.archiveofourown
\@user.ao3.org
\@user.ao3

There are four bugs:

ETA: 8 May 2020. This one seems to be fixed!
1. Markdown: When the shortcut is bracketed by backticks for `code` format, the display explodes shortcuts into raw HTML code

2. HTML and Markdown: periods disappear when they directly follow @user.sitename.tld or @user.sitename

(2a. Markdown: workaround! with @user.sitename.tld\. or @user.sitename\. the backslash escape permits the period to display as it should)

3. HTML and Markdown: Shortcut never expands before period for @user.site or @user.abbrev

4. Markdown at the phrase level -- bold, italic -- suppresses shortcut expansion, displaying @user.sitename.tld or its variants
jesse_the_k: USB jump drive pointing into my left ear (JK data in ear)

YouTube Userheads Now Included the @ in their URLs

YouTube has changed its usernames to include the @-sign

DW correctly displays the YT user head when I type

[youtube.com profile] ElleCordova

But that doesn’t link to her channel, which is

https://www.youtube.com/@ElleCordova

To get around this, make the userhead version the anchor to the YT link

[youtube.com profile] ElleCordova

or

[youtube.com profile] ElleCordova

the end

OK, today's code push should have killed off that last "mentions eat trailing periods (or just explode if they use a short sitename)" bug.

State of bugs, June 4

OK, so after perusing the examples throughout the community alongside their source text, here's what I'm seeing:

  • Most of the bugs are fixed.
  • The remaining bugs can be summed up as "user mentions before a sentence-ending period usually go bad."

Yeah? (edit: found the problem, PR here.)

That fits with the behavior changes I made recently, which went live in the (april? may?) code push. The current intended behavior for @mentions is:

Enabled for both HTML and Markdown.

NOT enabled when "don't autoformat" is set.

TEMPORARILY DISABLED within the following elements (both Markdown and HTML variants):

  • Code spans (<code> or backticks)
  • Preformatted blocks (<pre>; this also catches Markdown indented code blocks, which render to html as <pre><code>...</code></pre>)
  • <textarea>s
  • <raw-code>
  • embedded tweets (<blockquotes> that have a special class. kind of a weird exception.)

Errata

  • The "bold" examples below don't look like they're working, but that's just because user tag text is already styled with a bold font weight. If you inspect the HTML, you'll see they're properly wrapped in a <strong> element.
  • I didn't see any examples of this one yet, but user tags used to act weird inside links, in a variety of ways. Now, we should be using a non-linked variant of the user tag, so it looks right but doesn't break the link:
jesse_the_k: text: Be kinder than need be: everyone is fighting some kind of battle (Default)

updated bug 2, HTML version

The @ shortcut explodes when a period follows the username.sitename

If @username.sitename appears at the end of a sentence, like

> input: The best bug hunter is @punk.ao3.

Dreamwidth throws error message [ bad username or site: punk @ AO3. ] which includes the final period. Like this:

> The best bug hunter is [archiveofourown.org profile] punk.


Possible workarounds for HTML:

- precede the period with a zero-width-space character ref: the best bug hunter is [archiveofourown.org profile] punk.

- replace the period with the period character ref: the best bug hunter is [archiveofourown.org profile] punk.

- give up and use the old HTML format: <user name=runpunkrun> [personal profile] runpunkrun

Pre-push workaround was to add backslash before period, which no longer works

> the period is escaped by a backslash: the best bug hunter is [archiveofourown.org profile] punk\.

****

When the full TLD is included, user head displays correctly BUT it still swallows the period. Other punctuation is no problem.

The best bug hunter is [archiveofourown.org profile] punk.

Also known as actually [archiveofourown.org profile] punk.

That would be [twitter.com profile] runpunkrun.

Used to be [github.com profile] runpunkrun.

Why do you read [twitter.com profile] jesse_the_k? Never read [ao3.org--she profile] jesse_the_k's terrible. She never tweets at [twitter.com profile] jesse_the_k!
jesse_the_k: Lucy the ACD's butt & tail are all that's visible since her head is down a gopher hole (LUCY gopher hunter)

Updates to bug 2 after Apr 2020 code push

The @ shortcut explodes when a period follows the username.sitename

If @username.sitename appears at the end of a sentence, like

input: The best bug hunter is @punk.ao3.

Dreamwidth fails to expand, showing the error message [ bad username or site: punk @ AO3 ] and swallowing the period. Like this:

unescaped text, throws error that includes the period: The best bug hunter is [archiveofourown.org profile] punk.

(I formatted the input sample by surrounding the at-sign with backticks.)

Current workaround:

only the period is escaped inside backticks: the best bug hunter is [archiveofourown.org profile] punk.

Prepush workaround was to add backslash before period, which no longer works

the period is escaped by a backslash: the best bug hunter is [archiveofourown.org profile] punk.


When the full TLD is included, user head displays correctly BUT it still swallows the period.

The best bug hunter is [archiveofourown.org profile] punk.

Also known as actually [archiveofourown.org profile] punk.

That would be [twitter.com profile] runpunkrun.

Used to be [github.com profile] runpunkrun.

Other contacting punctuation doesn't trigger the bug

Why do you read [twitter.com profile] jesse_the_k? Never read [ao3.org--she profile] jesse_the_k's terrible. She never tweets at [twitter.com profile] jesse_the_k!

jesse_the_k: text: Be kinder than need be: everyone is fighting some kind of battle (Default)

ETA: FIXED! bug 1: markdown code format explodes shortcuts into visible HTML code

As of 8 May 2020, this bug seems to be fixed! HOORAY

markdown CODE format explodes shortcuts into visible HTML code

code follows @user.archiveofourown.org @user.archiveofourown.org end of code

code @user.archiveofourown.org @user.archiveofourown.org code code @user.archiveofourown.org @user.archiveofourown.org code

Code block @user.archiveofourown.org block block @user.archiveofourown.org @user.archiveofourown.org block block @user.archiveofourown.org

Code inside structure

  1. code follows @user.archiveofourown.org
  2. @user.archiveofourown.org end of code
  3. code follows @user.archiveofourown.org
  4. @user.archiveofourown.org end of code

live samples of other three shortcut styles )

jesse_the_k: text: Be kinder than need be: everyone is fighting some kind of battle (Default)

bug 2: Periods that follow @user.sitename.tld or @user.sitename disappear

Periods that follow [sitename.tld profile] user or [Bad username or site: user @ sitename] disappear

In two cases a following period disappears

  • fully qualified with user.sitename.tld
  • when tld is assumed user.sitename
user.sitename.tld
  • period [archiveofourown.org profile] user.
  • backslash period [archiveofourown.org profile] user.
  • paren ([archiveofourown.org profile] user)
  • hyphen -[Bad username or site: user @ archiveofourown.org-]
  • bang [archiveofourown.org profile] user!
  • question [archiveofourown.org profile] user?
  • slash period [archiveofourown.org profile] user/.
  • backslash period [archiveofourown.org profile] user.
user.abbrev.tld
  • period [archiveofourown.org profile] user.
  • backslash period [archiveofourown.org profile] user.
  • paren ([archiveofourown.org profile] user)
  • hyphen -[Bad username or site: user @ ao3.org-]
  • bang [archiveofourown.org profile] user!
  • question [archiveofourown.org profile] user?
  • slash period [archiveofourown.org profile] user/.
  • backslash period [archiveofourown.org profile] user.

Only in Markdown, backslash before period escapes the error

samples with two other styles )

jesse_the_k: text: Be kinder than need be: everyone is fighting some kind of battle (Default)

bug 3: shortcut doesn’t expand before period for user.site or user.abbrev

Shortcut doesn’t expand for user.site or user.abbrev

In two cases the period appears BUT the shortcut prints in body font instead of expanding

  • abbreviation with tld user.abbrev.tld
  • just abbreviation user.abbrev

ESCAPING THE PERIOD WITH BACKSLASH makes it print ONLY IN MARKDOWN not in text/html

live samples )

jesse_the_k: Text: "backbutton > wank / true story" with left arrow button (Back better than wank)

bug 4: Phrase-level Markdown displays but shortcut doesn't expand

Phrase-level format displays but shortcut doesn't expand

italic [archiveofourown.org profile] user

[archiveofourown.org profile] user italic

bold [archiveofourown.org profile] user

[archiveofourown.org profile] user bold

Structural Markdown format works

[archiveofourown.org profile] user h4

h4 [archiveofourown.org profile] user

Bullets

Numbers

  1. [archiveofourown.org profile] user number
  2. number [archiveofourown.org profile] user
  3. [archiveofourown.org profile] user number
  4. number [archiveofourown.org profile] user

Blockquote

[archiveofourown.org profile] user quote

quote [archiveofourown.org profile] user

[archiveofourown.org profile] user quote

quote [archiveofourown.org profile] user

Format Fails Even within Structure

Four h4s follow:

italic [archiveofourown.org profile] user

[archiveofourown.org profile] user italic

bold [archiveofourown.org profile] user

[archiveofourown.org profile] user bold

testing three other shortcut combos )