Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xxlabaza/nodejs-markdown-blog
Yet another markdown blog
https://github.com/xxlabaza/nodejs-markdown-blog
blog bootstrap express markdown nodejs tutorial
Last synced: 14 days ago
JSON representation
Yet another markdown blog
- Host: GitHub
- URL: https://github.com/xxlabaza/nodejs-markdown-blog
- Owner: xxlabaza
- License: apache-2.0
- Created: 2020-03-22T21:48:07.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-01-24T01:41:52.000Z (almost 2 years ago)
- Last Synced: 2023-03-01T14:32:16.664Z (over 1 year ago)
- Topics: blog, bootstrap, express, markdown, nodejs, tutorial
- Language: JavaScript
- Size: 2.56 MB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Overview
This is a yet another implementation of a markdown blog engine based on **Web Dev Simplified** [tutorial](https://www.youtube.com/watch?v=1NrHkjlWVhM) and customised (try to find my own NodeJS style...) by me.
The project's features:
* its frontend made with `Bootstrap` and `EJS` templates;
* stores data in `MongoDB` via `mongoose` library;
* runs `ESLint` before the tests;
* it has the tests with power of `Jest` and `supertest` (for API checks);
* uses `nodemon` for automaticaly restarting app during the development;
* it uses `Docker` and `docker-compose` tools for distribution, local launch and testing.
## Launch
### Docker compose
To run the project with a `docker-compose` tool, just type the following in a terminal:
```bash
$> docker-compose up --detach
Creating mongodb ... done
Creating markdown-blog ... done
```
To stop the project:
```bash
$> docker-compose stop
Stopping markdown-blog ... done
Stopping mongodb ... done
```
### Developer mode
To run the project in develop mode, start a **MongoDB** database, for example via a **Docker**:
```bash
$> docker run -p 27017:27017 mongo:4.2.3
...
```
Then, start the project itself:
```bash
$> npm run start:dev
> [email protected] start-dev /markdown-blog
> nodemon main.js
[nodemon] 2.0.2
[nodemon] to restart at any time, enter `rs`
[nodemon] watching dir(s): *.*
[nodemon] watching extensions: js,mjs,json
[nodemon] starting `node main.js`
...
```
Open [localhost:5000](http://localhost:5000) in your web browser and see something like the screenshots below.
**Main page**:
**Read an article**:
**Edit an article**:
