☰

AO3: [Wrangling] Rel Helper

on unwrangled rels, build the proper canonical tag name with minimal typing

作者
escctrl
日安装量
0
总安装量
4
评分
0 0 0
版本
2.4
创建于
2025-08-24
更新于
2025-10-23
大小
12.5 KB
许可证
MIT
适用于

💖 What it does

Build the proper canonical name of rels faster, with minimal typing (and therefore less chance of typos).

  • Pull the individual chars from the autocomplete just by clicking a button
  • Sort the added chars into their correct alphabetical order via drag & drop
  • Turns added chars into links, in case you need to check a tag comment about their alphabetization
  • Recognizes platonic/romantic rels automatically, switch with a button click
  • Can remove (and add back) all disambigs with a button click
  • Shows a preview of the canonical rel name that you're building
  • Will warn you if the rel exceeds the tag length limit (150) or if you're ending up with the same tag that you're on
  • You can choose your workflow:
    • you can either set the new tag as a Synonym Of directly
    • or you can copy the tagname and the selected chars to the clipboard, if you prefer going via the New Tag page

🪴 How to use it

  1. Open an unwrangled relationship tag to its Edit page.
  2. Click Add Chars to pull individuals names into the autocomplete, and pick the correct char from the suggestions. Repeat for each character.
  3. You can always add a character the regular way, by typing into the textfield.
  4. Once you have added all characters, drag & drop them into the correct alphabetical order. The characters are links to their wrangle pages (open in new tabs), so you can check how they were sorted in other rels.
  5. The script has automatically recognized the relationship type as romantic or platonic. If it guessed wrong, use the / or & button to switch.
  6. Click Remove Disambigs to remove fandom disambigs from all characters in the preview. (If all characters have the same disambig, it's still kept at the end.) Click Keep Disambigs to add them back.
  7. Select NF characters, such as "Other(s)", to append at the end.
  8. You can type in the Preview field! If there's something that requires manual adjustment, such as the removal of only one char's disambig, you can do that directly here. Do this last, since any other button-clicks will undo your manual changes.
  9. Depending on your workflow preferences, you'll have
    • a Set Syn Of button to copy the entire previewed tag name into the Synonym Of field
    • a Copy Rel button to copy the entire previewed tag name to the clipboard (so you can paste it into a New Tag page)
    • a Copy Chars button to copy a comma-separated list of the selected chars (to add them on the new canonical). This will also remove them from this tag, since syns generally don't need to have the chars attached.

🎨 How to configure it

Go to any Edit Tag page.

In the main navigation of AO3, next to “About”, there’s a new menu item “Userscripts”.

From the “Userscripts” menu, select the “Rel Helper Workflow” option. It toggles between the options "SynOf" and "Copy". The page refreshes with each change so you'll see the corresponding buttons.

🐞 Known limitations

When chars were already added and you refresh the page, they won't be links anymore. The preview will also be empty at first, but you can reorder the chars or click a button to make the preview appear again.

It only works on unwrangled rel tags. If the tag's already is a synonym of something, or a canonical tag, you won't see its buttons.

The script can't know individual characters' fandoms, so the logic for guessing which disambigs need to be removed is limited (as described above). On crossover rels or when dealing with chars that have in-fandom disambigs, you're probably better off removing the disambigs manually as the last step.

🏛️ History

  • v2
    • improved Remove Disambigs logic
    • add NF characters at the end
  • v1 - initial functionality

🏅 Credit

I'm a huge fan of the Add Characters from relationship script and needed to take this one step further. Also vaaas' keyboard shortcuts script had a Rel Helper (which I ditched when making my version of Keyboard Shortcuts).