Skip to content

Latest commit

 

History

History
46 lines (32 loc) · 2.73 KB

README.md

File metadata and controls

46 lines (32 loc) · 2.73 KB
Raw

Kiev-to-Kyiv

This is a browser extension that automatically converts the city name of "Kiev" to "Kyiv" on a web page. Ukrainians prefer the latter naming, despite Western familiarity with the former, because of its association with the country's Soviet past and the rendering being more faithful to the Ukrainian language.

It is made in the Manifest Version 3, and is therefore compliant with the rules of major extension stores such as the Google Web Store (as at 24th October 2022).

It was submitted to the 2022 CivicCode Hackathon under the category Empowerment. It was also submitted to the DeveloperWeek Enterprise Hackathon 2022 and Metro Hacks 2022 Hackathon.

History

Contrary to popular conception, Kyiv is a very old city as are the people of Ukraine. The city of Kyiv is believed to have

Technical details

As with all browser extensions, the Kiev to Kyiv browser extension is built in the following languages: HTML, CSS, JavaScript as well as JSON. The browser extension uses regular expressions within the JavaScript language to dynamically change references of "Kiev" to "Kyiv".

How this browser extension works is that it uses "regular expressions", a functionality found in many programming languages and in this particular context JavaScript, to detect where the word "Kiev" appears on a web page. Regular expressions look for certain words, numbers and symbols according to a predefined pattern. Once the word "Kiev" is found, it is then changed to "Kyiv".

Instructions

For Google Chrome

  • Instructions to use extension (when used for Google Chrome):
  1. Visit https://github.com/BabatundeOnabajo/Kiev-to-Kyiv
  2. Click on the Green button marked "Code".
  3. Click "Download Zip".
  4. Type "chrome://extensions" in the URL field
  5. Click "Developer mode"
  6. Click "Load unpacked". This will open up a file browser. Find out where the .zip file downloaded from Github was downloaded and then choose this file.
  7. The extension should now be in your browser!

For Mozilla Firefox

For Safari

Requirements

In order to use the Kiev to Kyiv extension, you will need to have the following:

  • Your browser must have JavaScript enabled
  • Internet browser - Google Chrome (Recommended), Mozilla FireFox (Recommended), Safari and/or Microsoft Edge

It is not necessary to have internet access to use this extension, although an internet connection is needed to install this extension to your device.

Further Details

Further details can be found by watching the YouTube video here: link

Credits

Babatunde Onabajo (ChurchMapped Limited)

Disclaimer

The code here is published by Babatunde Onabajo in an individual capacity. It does not necessarily reflect the views of any past, present or future employer.