DevOps

Essential

To locally host this site, follow these steps.

First time

Clone this repo and execute

npm i -g @codedoc/cli
codedoc install

to obtain all npm dependencies.

Every time

Execute

codedoc serve

to begin serving the website at localhost:3000.

Additional

There are some additional dependencies of codedoc/cli that might need to be installed first.

If port 3000 is being used, then a different one can be specified in the configuration.

Updating

• Execute codedoc update latest from .codedoc directory in a Windows terminal to update codedoc/cli
• Execute codedoc update latest --local to update codedoc/core
• Execute codedoc install @codedoc/coding-blog-plugin to update coding-blog-plugin

I have to update codedoc/cli from a Windows terminal because of this issue.

Acknowledgements

I could not have created this blog without lots of help.

Technologies

These wonderful technologies are used to make this site.

coding.blog

This blog is primarily powered by the CONNECT-platform.  It is deployed and hosted by coding.blog and most of the markdown features come from CODEDOC.

I was fortunate to be granted early access to coding.blog.  If you would like a blog like this, then go here and join their Prospective Creators List.

Eventually, you can financially support coding.blog in exchange for a personally curated content feed.  For now, you can go here and join their Waiting List for Beta.

utterances

Support for comments on posts is powered by utterances.  The comments are stored in post-specific issues in this GitHub repo.  Anyone with a GitHub account can add a comment.  If you authorize the utterances bot to post on your behalf, then you can add a comment directly from the post.  Otherwise, you can simply navigate from the post to the backing issue using the link provided above the first comment and post there yourself.

GitHub

Of course GitHub also plays a crucial role.  In addition to hosting the comments in select issues, all the content is committed into this repo. The website is redeployed shortly after master is updated.

Improvements?

Is there some improvement that you would like to see in my blog?  You can tell me about it by creating an issue or you can make the improvement yourself and then send me a pull request.