:abbr: markup is not obvious in some browsers (like Safari)

Ned Deily avatarNed Deily created an issue

Reviewing the draft Python devguide, it was noted that usages of :abbr:, resulting in <abbr>, were not noticeable at all in Safari unless the user happened to mouse over. It was reported that Chrome gives no visible clues as well, unlike Firefox. If there is nothing that can be done in Sphinx (via CSS attributes?), perhaps the documentation should warn about it.

Comments (3)

  1. Jochen Kupperschmidt

    I usually counter such behaviour using CSS:

      abbr,
      acronym {
        border-bottom: dotted 1px;
        cursor: help;
      }
    

    This resembles at least what I remember Firefox to style abbreviations like. Maybe that is an acceptable fix here.

  2. Éric Araujo
    • changed status to open

    It’s good practice to follow the convention used in writing, like in this example: “History in Mercurial does not form one line but a directed acyclic graph (DAG)”. That works with and without CSS or mouse or knowledge that the abbreviation will display more info when you hover over it. (Whether that information is sufficient for people who aren’t familiar with the abbreviation is another issue.)

    Advertising that practice is probably out of place for the Sphinx doc, which is not a style guide, but suitable for the Python docs.

  3. Log in to comment
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.