msdn-delocalizer

Sometimes, when looking for Microsoft documentation via a search engine, you may be presented with a link leading to a localized documentation page from Microsoft. Quality of translation varies a lot, but, as English speaker, you may choose to not deal with localization at all, and always look for English pages.

msdn-delocalizer is a browser (Chrome, Firefox) extension that will automatically delocalize Microsoft documentation pages, such as MSDN, docs.microsoft.com, or learn.microsoft.com.

Install

• Chrome Web Store
• Firefox Add-ons

Development

Prerequisites

• node.js v22 or newer
• yarn 1.22 or newer
• ImageMagick 7.0.11-12 or newer (only if you need to prepare a new extension icon)

To set the Node-related prerequisites up, you may use Volta:

$ volta install node@22
$ volta install yarn@1

Build

Install the dependencies:

$ yarn install

The project supports several build options. Use the following commands based on your needs:

• Development with hot reload: Launches a development server with hot reload. The extension files are placed in the build/{browser-name}-mv{mv-ver} directory.

  $ yarn run dev # for Chromium-based browsers (manifest v3)
  $ yarn run dev:firefox # for Firefox-based browsers (manifest v2)

• Build for production: Creates a production build of the extension in the build/{browser-name}-mv{mv-ver} directory.

  $ yarn run build # for Chromium-based browsers (manifest v3)
  $ yarn run build:firefox # for Firefox-based browsers (manifest v2)

• Create ZIP files for extension stores: Builds the extension for both Chrome and Firefox, generating two ZIP files in the build directory. Firefox-specific command also creates a zip with sources as its store requires them.

  $ yarn run zip # for Chromium-based browsers (manifest v3)
  $ yarn run zip:firefox # for Firefox-based browsers (manifest v2)
  $ yarn run zip:all # for all browsers

Test

$ yarn test

Icon (optional)

If you have prepared a new extension icon, then run the following shell command to add it to the package:

$ yarn run icon

Install (developer mode)

• Chrome: to install msdn-delocalizer to your Chrome in the developer mode, load the build/chrome-mv3 directory as the unpacked extension source, and refresh it after every rebuild.
• Firefox:
  • open Settings via the main menu,
  • enter the Extensions and Themes page
  • click the Debug Add-ons action from the page gear menu
  • Load Temporary Add-on, navigate to the build/firefox-mv2 and select manifest.json

Documentation

• Changelog
• Maintainership
• License (MIT)