vdock
Intro:
Vdock is a tool with an intergrated IDE for managing hugo site efficiently.
It provides features like
- Integrated IDE (Cloud9)
- Live preview(changes)
- 1-click to create new post
- 1-click to publish final site to github pages
- snippets(markdown) to ease content writing
Prerequisities(One time setup)
Github.com account.
Step 1 : Logon to yourBlog-Source
Step 2 : Create a repository for storing your <Github-userid>.github.io
to host your site.
Step 3 : Create a repository with name Suppose If your github-userid is rchari66
then the repository name would be
rchari66.github.io
Run :
No Authentication & Deny Public Access
$ docker run -td -p 8288:8288 -p 8286:8286 rchari/vdock
With Authentication & Deny Public Access
$ docker run -td -p 8288:8288 -p 8286:8286 -e AUTH=rchari:vdock rchari/vdock
open : http://localhost:8288/
More Ways To Run vdock Securely
With Authentication & Deny Public Access
$ docker run -td -p 8288:8288 -p 8286:8286 -e AUTH=<username>:<password> rchari/vdock
No Authentication & Allow Public Access
$ docker run -td -p 8288:8288 -p 8286:8286 -e ALLOW_PUBLIC_ACCESS=YES rchari/vdock
With Authentication & Allow Public Access
$ docker run -td -e AUTH=<username>:<password> ALLOW_PUBLIC_ACCESS=YES \
-p 8288:8288 -p 8286:8286 rchari/vdock
vdock
in config
page
Configure
fetchRepositories
button
Step 1 : Enter your github id and click
Step 2 : Select repositories and Enter Other details.
Select
hugo-sample-source
and<Githuh-userid>.github.io
repos forBlog Source:
andBlog Destination:
Provide Github email and Github password and then Click on button
Update Configure
. This will createblog-source
andmySite
directries in the IDE.
blog-source/config.toml
) for hugo
Configure config.toml(in Make sure
publishDir
is set to../MySite
.
publishDir = "../MySite"
Update
baseURL
tohttps://<Github-userid>.github.io
.
baseURL = "https://rchari66.github.io"
Publish your site.
Simply goto
publish
page and click onPublish Changes
(provide a commit message in textbox).
Wait for one or two minutes and then open https://<Github-userid>.github.io to view your site.
here for enabling github pages for your repository.
In case the site in not available after couple of minutes then referRefer : How to Create blog posts Using vdock
TODO: Enhancements/Imporovements:
- Support for Gitlab & Bitbucket
- Add Google analytics & disqus config to default themes.
- One click theme(hugo) selection
- Enhance this tool to ease kubernetes related stuff
- 1-Click publish to S3(aws) Bucket
- 1-Click to host the static site on ec2 instance
- Support for dynamic services(Web services by Golang)