Skip to content

Latest commit

 

History

History
51 lines (35 loc) · 2.05 KB

README.md

File metadata and controls

51 lines (35 loc) · 2.05 KB

Browser extension "Search with DWDS"

Work in progress on a browser extension which interacts with the German online dictionary DWDS. This extension allows for add the DWDS to the list of search engines, forwarding selected text to the DWDS search page on right-click, and typing dwds in the address bar to show search tools and suggestions.

Current status

  • Add DWDS to the list of search engines
    • Firefox ✔️
    • Chromium ❓ ("Some extensions can add search engines to Chrome")
  • Select text + right-click and "search with DWDS"
    • Firefox ✔️
    • Chromium ✔️
  • Omnibox, i.e. shortcuts in address bar (functionality present but may vary)
    • Firefox ✔️
    • Chromium ✔️

Build process

  1. Install Node Version Manager (nvm)
  2. Install web-ext: npm i -g web-ext
  3. Run build.sh

Test process

  1. Install Python (with the systems default package manager; with asdf; etc.)
    1.1 On Linux base systems also install tk with
    sudo apt install python3-tk python3-dev or
    sudo pacman -S tk or
    sudo yum install python3-tk
    depending on your distro..
  2. Create virtual environment with python -m venv venv
    2.1 Activate env with source ./venv/bin/activate
    2.2 Install required packages pip install -r requirements.txt
  3. Run python test.py to run the End-to-End Test with
    -> selenium: for controlling the browser
    and
    -> pyautogui: for controlling the mouse

Instead of 2. it's also possible to run ./setup-tests.sh

Firefox must be installed to run the test!

Publication