☰

AO3: [Wrangling] Rel Helper

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

作者
escctrl
今日安裝
0
安裝總數
0
評價
0 0 0
版本
1.0
建立日期
2025-08-24
更新日期
2025-08-24
尺寸
11.0 KB
授權條款
MIT
腳本執行於

💖 What it does

Build the proper canonical name of rels faster, with minimal typing.

  • 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 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
preview of the Rel Helper in use, adding a character manually, another by clicking the Add Char button, then dragging the two characters into their order by alphabet. The rel is switched from romantic to platonic, which exchanges slashes with ampersands. The preview alerts that the rel is too long and one character still has a disambig. After clicking Remove Disambig the fandom disambig is removed and the rel is short enough to be used.

🪴 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 chose the wrong one, use the / or & button to switch.
  6. Click Remove Disambigs to remove fandom disambigs from all characters in the preview, if needed. Click Keep Disambigs to add them back.
  7. 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.
  8. 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.

🏛️ History

  • 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).