Skip to content

A simple and dumb blogging platform made on the Angular Framework.

License

Notifications You must be signed in to change notification settings

pedroCX486/ngx-dumblog

Repository files navigation

ngx-Dumblog

A simple and dumb blogging platform with an editor in-browser (you need to commit/upload your files after editing them). Made to be an alternative to Jekyll.

Customizations

On the settings.json file you'll find options to customize your blog title, avatar, bio, social networks (leave the fields empty, don't delete them if you don't want them showing up!), ability to enable Disqus (check the Disqus.js file for more instructions) and ability to select how many posts will be shown on the home page.

Pre-built version

You can download the pre-built versions in the releases page. Just unzip, customize your settings.json, hello-world.json and archives.json as you'd like and commit the files to your github.io repo!

Creating and editing posts

You can go to YOUR_USERNAME.github.io/?page=editor to see the online editor. From there you can create and edit posts. To have those posts reflect on Github, you need to place and commit the files it generates in the assets/posts folder of your install.

Running locally

First run npm install then run npm start and it should open automatically on http://localhost:4200/.

Build

Run npm run build to build it. You can also run custom-build.bat to build it and then have the index.html title changed after build. But first change the variable BLOGNAME inside the .bat file! I intend to add a tool in the future capable of reading the name from the settings.json and then updating the index.html after the build, instead of keeping this .bat file.

Contributing

Just do a pull request. :-)

Why?

Because I always thought Jekyll to be too convoluted and I wanted something dumb and simple. The code isn't an example of awesomeness but it does the job and pretty well at that. Way better than the bullshit that was the old version in JQuery and C#.