Logo

Getting started

  • Tutorial
  • Adding a documentation project
  • Popular documentation tools
  • Example projects

Project setup and configuration

  • Configuration file overview
  • Configuration file reference
  • Read the Docs Addons
  • Account authentication methods
  • Automation rules
  • How to create reproducible builds

Build process

  • Build process overview
  • Build process customization
  • Git integration (GitHub, GitLab, Bitbucket)
  • Pull request previews
  • Build failure notifications
  • Environment variable overview
  • Environment variable reference

Hosting documentation

  • Versions
  • Subprojects
  • Localization and Internationalization
  • URL versioning schemes
  • Custom domains
  • Documentation notifications
  • Canonical URLs
  • Content Delivery Network (CDN) and caching
  • Sitemap support
  • 404 Not Found pages
  • robots.txt support

Reading documentation

  • Offline formats (PDF, ePub, HTML)
  • Visual diff
  • Link previews
    • Enabling link previews
    • Troubleshooting link previews
  • How to embed content from your documentation
  • Server side search
  • Search query syntax
  • Flyout menu

Maintaining projects

  • Redirects
  • Traffic analytics
  • Search analytics
  • Security logs
  • Status badges
  • How to structure your documentation
  • Best practices for linking to your documentation
  • Security considerations for documentation pages

Business features

  • Business hosting
  • Organizations
  • Single Sign-On (SSO)
  • Sharing private documentation
  • How to manage your subscription
  • Privacy levels

How-to guides

  • Project setup and configuration
  • Build process
  • Upgrading and maintaining projects
  • Content, themes and SEO
  • Security and access
  • Account management
  • Best practice
  • Troubleshooting problems

Reference

  • Public REST API
  • Frequently asked questions
  • Changelog
  • About Read the Docs
  • Developer Documentation
  • Read the Docs website
Read the Docs user documentation
  • Link previews
  • Edit on GitHub

Link previews

Link previews allows you to see the content of the link you are about to click when you hover over it. This gives you the ability to quickly preview where a link points, so you can keep your context while reading but learn more from other resources.

_images/addons-link-previews.png

Example of link previews addon

Link previews will only be generated for internal links–links that point to pages within your documentation site. No link previews will be generated for links to external sites or links that appear outside of the primary content of the documentation page (eg. nav bars).

You can see an example of a link preview by hovering over the following link: Addons.

Enabling link previews

  1. Go to the new dashboard.

  2. Click on a project name.

  3. Go to Settings, then in the left bar, go to Addons.

  4. Go to Link previews and check Enabled.

  5. Save your settings – a rebuild of your project isn’t required!

Troubleshooting link previews

We perform some heuristic to detect the documentation tool used to generate the page based on its HTML structure. This auto-detection may fail, resulting in the content rendered inside the popup being incorrect. If you are experiencing this, you can specify the CSS selector for the main content in Settings > Addons > Advanced, or you can open an issue in the addons repository so we improve our heuristic.

Link previews won’t be generated if JavaScript is not enabled in your web browser or if all cookies are blocked.

Previous Next

© Copyright Read the Docs, Inc & contributors.

Built with Sphinx using a theme provided by Read the Docs.