About-
- 'Blog' and 'blogging' are now loosely used for content creation and sharing on social media, especially when the content is long-form and one creates and shares content on regular basis.
- This is a dynamically updating Blog posting website developed primarily using Node Js with EJS template engine and Mongoose as ODM(Object Data Modeling library).
Visit website
Technology Stack 🛠️
Environment Setup for local use-
- Drop a ⭐ on the GitHub repository.
- Download Git (when you install Git, Git Bash also gets installed by default)
- Download and install a code/ text editor.
- Recommended-
- Download Node Js and npm(Node package manager) (when you install Node, npm also gets installed by default)
- Mongo DB community editition is free and a great software in order to work with MongoDB applications. Download Mongo DB community editition
- Robo 3T is a desktop graphical user interface (GUI) for Mongo DB. It can help to skip running all the Mongo DB commands manually every time we want to access the data. Download Robo 3T (optional)
- Clone the repository by running command
git clone https://github.com/<your user-name>/WordNook.git
in your git bash.
- Run command
cd WordNook
.
- Run this command to install all dependencies for the project.
npm install
- Adding secret key for JWT auth.
- Run this command when inside the root directory to make a
.env
file.
touch .env
- Now add this to the
.env
file
SECRET_KEY = AlphaVio URL = mongodb://localhost:27017/wordnookDB
- Run this command when inside the root directory to make a
- Testing : Run this command on your terminal/ bash to start the Mongo server on port 27017(default).
mongod
- Run this command to start the project.
npm start
or
- Run this command to start the project as a developer.
npm run dev
- Open link to view the website in your browser window if it doesn't open automatically.
http://localhost:3000/
- You can learn more about EJS template engine and its syntax to know how we can use it inside our HTML using the documentation
- Now you are all set to use this project.
Some useful Mongo DB commands if you are using the terminal instead of the GUI-
show dbs
use db <db name>
show collections
<db name> .find()
Visit WordNook
Project Deployed on Heroku :Note -
- If your git shows an issue with your
package-lock.json
while installing dependencies or throws error that lockfile version-2 is not compatible with your system Then check your npm version by running commandnpm version should be 7 and above for lockfile version-2 that would come by default if you have a node version 15 and above.npm --version
List of Node.js releases and corresponding npm versions
Disclaimer-
The Contact Us
feature might not work in the local environment since the API-Key has not been shared. If you still want to work on it, generate your own API key from Mail Gun and include it in the .env
file as
MAILGUN_API_KEY = <your-api-key>
Open Source Events Project is associated with:
- JWoC ( JGEC Winter of Code) is a program organised by Developers JGEC in collaboration with Sristi 2020 which helps students to plunge into the realm of Open Source contribution and Software Development.
- Mexili is a Free and Open Source organization whose motivation is to funnel learning and implementation through Open Source Software Development.
- GirlScript Summer of Code is the 3 month long Open Source program conducted by GirlScript Foundation, started in 2018, with an aim to help beginners get started with Open Source Development while encouraging diversity.
Maintainers ✨
Pranav Mendiratta 💻📖 🚧 |
Ananya Negi 💻 📖 🚧 |
Rushan Khan 💻 📖 🚧 |
Contributors ✨
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!