Coder Social home page Coder Social logo

amineaouragh / abbreve Goto Github PK

View Code? Open in Web Editor NEW

This project forked from njong392/abbreve

0.0 1.0 0.0 199 KB

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

Home Page: https://abbreve.vercel.app/

License: Apache License 2.0

JavaScript 88.08% CSS 8.33% HTML 3.59%

abbreve's Introduction

๐ŸŽ‰ Welcome to Abbreve

Abbreve is an open source dictionary for slangs. 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. Screenshot of form section of page with 'lgtm' 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.

๐Ÿ’ก 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;

To start contributing,

Prerequisites

You need to have,

  • Node installed
  • Basic knowledge of Git

Steps

  1. Fork this repositiory
  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, and open a pull request.

Adding an abbreviation

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

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

  2. To add a new abbreviation, you must append a new object to this file.

    • The slang must be in lowercase. For example, lgtm not LGTM
    • The first letter of each word in the definition and alternatives must be uppercase. For example, Looks Good To Me
  3. The Screenshot below could help Screenshot of db.json file in IDE with highlighted section

    • The highlighted section is an example of the way you would add an abbreviation.
    • Before you add a new object, end the one above with a comma. If not, there will be errors in your JSON. Your IDE should indicate this.
  4. If a slang does not have alternatives, add only a definition

Only English slangs are accepted as of yet.

๐Ÿ’ฃ Now, GO CREATE THOSE ISSUES AND PULL REQUESTS!

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.