=== Software Dictionary Term Linker ===
Contributors: softwaredictionary
Tags: glossary, tooltip, definitions, programming, links
Requires at least: 6.3
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Links the software terms in your posts to plain definitions, with a short definition on hover. No cookies, no tracking.

== Description ==

Writing about software means using words your readers may not know yet: API, Docker, cache, load balancer. This plugin finds those terms in your posts and links each one to its page on [Software Dictionary](https://softwaredictionary.org), a free glossary of software terms in plain English and Turkish. Hover a linked term, or move to it with Tab, and a short definition appears.

* Each term is linked once, on its first mention, so the post stays easy to read.
* Code, headings, buttons and existing links are never touched. Everyday words that are software terms only in context ("branch", "commit", "session") are left alone.
* English or Turkish: terms link to the edition your posts are written in.
* About 7 KB of JavaScript with no dependencies, loaded only on single posts and pages by default.
* No cookies, no tracking, no account.

Settings are under **Settings → Software Dictionary**: the language, where to look for the post's text, and how many terms to link at most.

== External services ==

This plugin uses Software Dictionary (https://softwaredictionary.org) to know which software terms exist and what they mean.

When a reader opens a post, their browser downloads the term list with each term's name, short definition and address: https://softwaredictionary.org/term-linker-data.json, or https://softwaredictionary.org/tr/term-linker-data.json for Turkish. Nothing about your site or your readers is sent with it, and no cookies are set; the request is an ordinary file download, cached by the browser.

The definitions are licensed CC BY-SA 4.0, and each definition card names Software Dictionary and links to the full page.

* Privacy policy: https://softwaredictionary.org/privacy
* About the service: https://softwaredictionary.org/about

== Installation ==

1. In your dashboard, go to **Plugins → Add New**, search for "Software Dictionary Term Linker", then install and activate it. Or upload the plugin's zip file under **Plugins → Add New → Upload Plugin**.
2. Open **Settings → Software Dictionary** and pick the language your posts are written in.
3. Open any post: its software terms are now linked.

== Frequently Asked Questions ==

= The terms aren't linked in my theme. =

Your theme may not put the post inside an `.entry-content`, `article` or `main` element. Set **Where to look** to the selector of your theme's post content.

= Can I skip a part of a post? =

Yes. Wrap it in an element with `data-term-linker="off"`, for example `<div data-term-linker="off">…</div>`.

= Does it slow my site down? =

The script is small, loads after the page with `defer`, and the term list is downloaded once and cached by the browser.

= Does it work with page builders and caching plugins? =

Yes. The linking happens in the reader's browser after the page loads, so cached pages work as usual.

== Screenshots ==

1. Software terms in a post, each linked once, on its first mention.
2. Hover a linked term, or move to it with Tab, and a short definition appears.
3. The settings: the language, where to look for the post's text and how many terms to link.

== Changelog ==

= 1.0.0 =
* First release.
