Star

banner

banner

coding.blog Plugin

A plugin designed to help you create a nice programming blog using CODEDOC, with config helpers for hosting it on coding.blog, though you can host it anywhere you see fit (i.e. GitHub Pages).


linkWhat is CODEDOC?

CODEDOC is an open-source tool for easily creating modern, elegant articles about programming. It creates beautiful and feature-rich JAMStack apps from a bunch of markdown files, which can then be hosted on services like GitHub Pages or coding.blog.

CODEDOC was designed to help with writing documentation and tutorials, but due to its customizability it can be easily adapted for writing beautiful blogs as well, which is basically what this plugin provides.


CODEDOC Documentation

linkWhat is coding.blog?

coding.blog is a semi-centralized blog platform for all things coding. You maintain your content on your own git repo (which must be a CODEDOC project), and hook it up to <your>.coding.blog. The coding.blog curators team will then make sure that people who would like to hear about your posts, do hear about it.


Learn More about coding.blog

linkWhat does this plugin provide?

Most importantly, a set of CODEDOC components specifically for blogging:

It also provides stylesheets for making your posts more blog-looking, plugs in post-processors that automatically add Twitter and Open-Graph meta tags for each page, and offers a convenient way of configuring your assets for hosting on coding.blog.


linkGetting Started

The recommended way of creating a blog for coding.blog is to fork this repository, as it has all the necessary plugins and dependencies (including this plugin) pre-installed, and is pre-configured for easy deployment to GitHub Pages and coding.blog.


linkOn Existing CODEDOC Repo

If you already have a blog repo based on CODEDOC, you can install this plugin like this:

STEP 1
Install the plugin:

1linkcodedoc install @codedoc/coding-blog-plugin

STEP 2
Edit .codedoc/config.ts and add the plugin to plugins:

.codedoc/config.ts
1linkimport { configuration } from '@codedoc/core';

2linkimport { codingBlog } from '@codedoc/coding-blog-plugin'; // --> import the plugin

3link

4link// ...

5link

6linkexport const config = /*#__PURE__*/configuration({

7link // ...

8link plugins: [

9link // ...

10link codingBlog() // --> plug the plugin in

11link ],

12link // ...

13link});


What is CODEDOC?What is coding.blog?What does this plugin provide?Getting StartedOn Existing CODEDOC Repo

Home Hero Images Titles Author Info Article Cards Tags RSS Miscellaneous Assets