Add i18n support and document toggle button languages

Updated CHANGELOG, README, and docs to document new internationalization support for toggle button texts. Added a list of supported languages and instructions for configuring language in Sphinx. Also mentioned new functions for dynamic hint updates and a fix for using existing admonition IDs.

Author: douden

CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## Unreleased
+
+### Added
+
+- Support for more languages in toggle button text (see README for full list) [#66](https://github.com/executablebooks/sphinx-togglebutton/pull/66).
+- Added new functions (syncToggleHint, syncAllToggleHints) to dynamically update toggle button hints based on the current state  [#66](https://github.com/executablebooks/sphinx-togglebutton/pull/66).
+
+### Fixed
+
+- Update togglebutton.js to use an admonition's existing ID if present, instead of always generating a new one [#66](https://github.com/executablebooks/sphinx-togglebutton/pull/66).
+
 ## v0.3.2 - 2022-07-15
 
 ([full changelog](https://github.com/executablebooks/sphinx-togglebutton/compare/v0.3.1...347b1ad3a093afad0f0d4c0041249f09f39afab2))

README.md

@@ -69,3 +69,10 @@ here's a container with an image inside:
 
         .. image:: https://media.giphy.com/media/mW05nwEyXLP0Y/giphy.gif
 ```
+
+Internationalization (i18n)
+============
+
+The texts `Click to hide` and `Click to show` used in the toggle buttons are internationalized by using the set language from Sphinx's configuration.
+
+Supported languages are English (default), Chinese (Simplified), Chinese (Traditional), Hindi, Spanish, French, Arabic, Bengali, Russian, Portuguese, Indonesian, Japanese, German, Korean, Turkish, Vietnamese, Tamil, Italian, Thai, Dutch, Greek, Polish, Ukrainian, Persian, Malay, Swahili, Romanian, Czech, Hungarian, Hebrew, Swedish, and Norwegian.

docs/use.md

@@ -129,7 +129,16 @@ Here is my toggle-able content!
 ## Change the button hint text
 
 You can control the "hint" text that is displayed next to togglebuttons.
-To do so, use the following configuration variable in your `conf.py` file:
+
+To use the default values for your language, set the language in your Sphinx configuration:
+
+```python
+language = "nl"  # or "de", "es", etc.
+```
+
+Supported languages are English (default), Chinese (Simplified), Chinese (Traditional), Hindi, Spanish, French, Arabic, Bengali, Russian, Portuguese, Indonesian, Japanese, German, Korean, Turkish, Vietnamese, Tamil, Italian, Thai, Dutch, Greek, Polish, Ukrainian, Persian, Malay, Swahili, Romanian, Czech, Hungarian, Hebrew, Swedish, and Norwegian.
+
+If you prefer to have custom hint texts instead of the defaults for your language, use the following configuration variable in your `conf.py` file:
 
 ```python
 togglebutton_hint = "Displayed when the toggle is closed."