Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/zevlg/multitran.el

Emacs interface to multitran.com
https://github.com/zevlg/multitran.el

ellit-org gnu-emacs

Last synced: 13 days ago
JSON representation

Emacs interface to multitran.com

Awesome Lists containing this project

README

        

#+options: timestamp:nil
#+title: multitran.el
#+author: Zajcev Evgeny
#+startup: showall

#+begin_quote
This file is automatically generated from =multitran.el= by
[[https://github.com/zevlg/ellit-org.el][GitHub#ellit-org.el]] tool.
Do not edit manually.
#+end_quote

=multitran.el= is a zero-dependancy interface to
http://multitran.com online dictionary.

=multitran.el= supports *tons* of languages, including such
languages as: Esperanto, Latin and Luxembourgish. See
[[https://www.multitran.com/m.exe?a=1&all=32][full languages
list]], and feel free to add new languages to
`multitran-languages-alist' if you missing one.

Use @@html:@@M-x multitran RET@@html:@@ to get the translation for the
word at point. Specify @@html:@@C-u@@html:@@ prefix arg to interactively
select translation languages.

* Installing
:PROPERTIES:
:CUSTOM_ID: installing
:END:

Install from [[http://melpa.org][MELPA]] using
@@html:@@M-x package-install RET multitran RET@@html:@@.

Make sure your MELPA package archive is up-to-date with
@@html:@@M-x package-refresh-contents RET@@html:@@

* Variables to customize
:PROPERTIES:
:CUSTOM_ID: variables-to-customize
:END:

You can customize =multitran.el= with @@html:@@M-x customize-group RET multitran RET@@html:@@ using Emacs
[[https://www.gnu.org/software/emacs/manual/html_node/emacs/Easy-Customization.html#Easy-Customization][Easy
Customization Interface]]

Or just tweak following user options in your =init.el=:

- User Option: ~multitran-languages~

Pair of languages for translation, for example
~("Russian" . "English")~ for russian <-> english translation.

- User Option: ~multitran-header-formatters~

List of format functions to compose multitran header.

You might want to add your custom formatters, such as:
#+begin_src emacs-lisp
(defun my-multitran--hf-wordfreq ()
"Show word's frequency rank."
(let ((wfreq (wordfreq-find (or multitran-word ""))))
(and wfreq (format "FRank: %S" (cadr wfreq)))))

(setq multitran-header-formatters
'(miltitran--hf-word multitran--hf-languages
my-multitran--hf-wordfreq multitran--hf-history))
#+end_src

Where ~wordfreq-find~ is from
[[https://raw.githubusercontent.com/zevlg/emacs-stuff/master/wordfreq.el][wordfreq.el]]

* Integration with avy
:PROPERTIES:
:CUSTOM_ID: integration-with-avy
:END:

=multitran= can be be integrated with =avy= actions. For example:
#+begin_src emacs-lisp
(cl-pushnew (cons ?M 'multitran-at-pos) avy-dispatch-alist)
#+end_src

* History
:PROPERTIES:
:CUSTOM_ID: history
:END:

** Version 0.5.1:
:PROPERTIES:
:CUSTOM_ID: version-051
:END:

- Parse #8 color
- Get rid of tag in subjects

** Version 0.5.0:
:PROPERTIES:
:CUSTOM_ID: version-050
:END:

- Adapt to multitran.com API changes, thanks to @avityazev
- Rip off links to images

** Version 0.4.16:
:PROPERTIES:
:CUSTOM_ID: version-0416
:END:

- Use ~:extend~ attribute for the ~multitran-section-face~ face.

** Version 0.4.15:
:PROPERTIES:
:CUSTOM_ID: version-0415
:END:

- Fixes due to multitran.com API change

** Version 0.4.14:
:PROPERTIES:
:CUSTOM_ID: version-0414
:END:

- Fixes due to multitran.com API changes
- Title format has been changed, so we multitran adopted regex
to extract word from the title.

** Version 0.4.11:
:PROPERTIES:
:CUSTOM_ID: version-0411
:END:

- Use ~word-at-point~ instead of ~current-word~ for better word
at point recognition.
- Integration with =avy= by providing ~multitran-at-pos~ function.

** Version 0.4.10:
:PROPERTIES:
:CUSTOM_ID: version-0410
:END:

- Support for symbols like =⇒=; seen in "go" translation
- Support for ==, seen in "the" translation

** Version 0.4.1:
:PROPERTIES:
:CUSTOM_ID: version-041
:END:

- Select custom languages if @@html:@@C-u@@html:@@ is supplied to
@@html:@@M-x multitran RET@@html:@@
- Fixes due to multitran.com API changes

** Version 0.4:
:PROPERTIES:
:CUSTOM_ID: version-04
:END:

- Use last translation word if no current word
- Parse "English thesaurus" anchor for abbr look like words,
for example @@html:@@M-x multitran RET sath RET@@html:@@
- Show "Can't translate" messsage instead of
"Search failed: Suggest:
"
- Save ~multitran-languages~ in history
- ~multitran-prev-link~ implemented, now @@html:@@@@html:@@ is working
- Infinite loop bug fixed in ~multitran-next-section~

** Version 0.3:
:PROPERTIES:
:CUSTOM_ID: version-03
:END:

- Parser for =reliability-of-translation= span
- Workaround some html bugs (triggered by en-de translations)

** Version 0.2:
:PROPERTIES:
:CUSTOM_ID: version-02
:END:

- Support for ~header-line-format~
- Support for suggestions
- Many languages added

** Version 0.1:
:PROPERTIES:
:CUSTOM_ID: version-01
:END:

- Base port of some =rdict.el= functionality
- html parsers