/Abbreve

A simple website, that fills out abbreviations for popular slangs.

Primary LanguageJavaScriptApache License 2.0Apache-2.0

🎉 Welcome to Abbreve

Abbreve is an open-source dictionary for slang. Writing on the internet is currently the most common way of communication, but keeping up with the abbreviation style is becoming difficult.

Abbreve helps you keep up, by providing meanings to these abbreviations.

🎥 Project Overview

You can check out the live project here

All you need to do is start entering a slang in the search bar, and the meaning will be provided. Below the main meaning of the slang could be alternative meanings.

Gif of form section of page with 'various types into the search bar, it's meaning below it, and alternative meanings

📣 Want to contribute?

We would love to have you! Abbreve is open source and we are keen on hearing what you have to say. Do check out the code of conduct for rules and guidelines, and our CONTRIBUTING.md file for any steps you might need.

💡 Getting Started

Found a bug? Accessibility issue? Or do you want to add an abbreviation to our database? Then go right ahead and create an issue.

Tech Stack

This project uses:

Prerequisites

Before installation, you need to have the following:

  • Node installed
  • Basic knowledge of Git

Steps

  1. Fork this repository.
  2. In your terminal, clone your fork using git clone <link to your fork>.
  3. Run cd Abbreve to navigate to project directory.
  4. Run npm install to add node_modules folder.
  5. To start the server on localhost, run npm run dev.

This project uses Vite, but that shouldn't overwhelm you. Everything works pretty much the same.

  1. Make your changes, push your code, and open a pull request.

Adding an Abbreviation

Before adding an abbreviation, please make sure that the new entry does not already exist. You can easily check this by entering the slang on the live site to see if it gives a result or not.

For now, we use JSON to store the abbreviations. We hope to improve on this as time goes on.

We provide two ways for adding new abbreviations.
1. Manually adding in the db directory
2. Using the CLI

1. Manually adding in the db directory

This option requires you to manually create definition files in the public/server/db directory. Follow the steps below to manually add an abbreviation

  1. In the /public folder, open the /server folder and subsequently, the /db folder you find in it. You can see that each slang is a JSON file of its own.

  2. To add a new abbreviation, you must create a new file.

    • The file name should be the slang you want to add. For example, lgtm.json is the file for the slang lgtm
    • The file name must be in lowercase. For example, lgtm.json not LGTM.json
  3. Inside the file you created, create a new object to store the defintion of the slang, and/or alternative definitions. Taking lgtm as an example again,

    {
        "definition": "Looks Good To Me",
        "alternatives": "Looks Great To Me, Looks Great To Merge"
    }

    definition is the most common abbreviation for the slang, and alternatives is/are other ways people use the slang.

  4. As you can see above, the first letter of each word in both definition and alternatives is uppercase.

  5. If a slang does not have alternatives, add only a definition. For example, in the asap.json file for the slang asap,

    {
        "definition": "As Soon As Possible"
    }

    ℹ️ If you encounter any issues with the file naming, kindly use the CLI option instead

2. Using the CLI

Using our CLI to add slang is very easy, as it handles all file naming issues and also validates the definitions to ensure that they follow our naming conventions.
Follow the steps below to add new slang using our CLI

  1. From your terminal, run the db:entry script. E.g npm run db:entry
  2. Choose the first option (Add a new abbreviation)

    💡 You can choose an option using your up/down arrow keys

  3. Input the abbreviation you want to add and press Enter
  4. After your input, another question pops up, asking if you have alternative definitions. If you do, press y, followed by Enter. If the slang does not have any alternative definition, press n then Enter.

    If you have other alternatives, enter the alternative and press Enter to add. When you are done add all your alternatives, press Enter without entering anything else

    ℹ️ When adding multiple alternatives, do not separate them with a comma like you would do when manually entering into db. Instead, press Enter after each alternative entry until you are done with all your entries.

  5. If you have other slang to add, press y and repeat from step 1. Else, press n and then Enter.
  6. Review your changes in the public/server/db directory

If you encounter any error whiles using the CLI, kindly report it here

The GIF below demonstrates how to use the CLI to add new abbreviations

CLI DEMO

⚠️ IMPORTANT Naming Conventions

Before pushing your changes, please check and ensure that all your additions follow the naming conventions listed below:

  • The slang must be in lowercase. For example, lol and not Lol or LOL
  • The first letter of each word in the definition and alternatives must be capitalized. For example, Looks Good To Me and not Looks good to me or looks good to me

Only English slang are accepted as of yet.

💣 Now, GO CREATE THOSE ISSUES AND PULL REQUESTS!

🔑 License

This project is licensed with Apache 2.0.

If you like the project, Don't forget to leave a star ⭐ . All support is highly appreciated 💯