CoreDNS website
Go to file
coredns-auto-sync[bot] 9ffe73d728 auto content sync 2021-03-08 11:28:22 +00:00
.github Use more descriptive action function name 2020-02-06 12:16:31 +00:00
archetypes New design 2017-07-24 15:47:09 +00:00
bin sync: add overrides 2020-03-24 15:45:46 +01:00
content auto content sync 2021-03-08 11:28:22 +00:00
data coredns 1.8.3 release (#216) 2021-02-24 15:06:32 +01:00
layouts Auto build and deploy via Netlify (#179) 2020-02-06 12:44:16 +01:00
static Cure53 (#82) 2018-03-25 17:58:03 +01:00
style Add image to manual (#74) 2018-02-27 15:16:26 +00:00
themes/coredns Some small changes to {ex}plugin pages 2020-10-14 07:46:23 +02:00
.gitignore Auto build and deploy via Netlify (#179) 2020-02-06 12:44:16 +01:00
.netlify.toml Auto build and deploy via Netlify (#179) 2020-02-06 12:44:16 +01:00
Caddyfile Add Caddyfile 2017-07-25 07:13:03 +01:00
Makefile v181 (#214) 2021-01-20 13:16:36 +01:00
README.md v181 (#214) 2021-01-20 13:16:36 +01:00
_redirects Add redirects (#189) 2020-03-11 17:28:54 +01:00
config.toml Disabled popup 2018-10-21 16:15:53 +01:00
go.mod Github Action to automatically sync content (#178) 2020-02-06 11:24:56 +01:00
go.sum Github Action to automatically sync content (#178) 2020-02-06 11:24:56 +01:00

README.md

coredns.io

Purpose:

  1. What is CoreDNS?
  2. How to use it?
  3. How to get involved and get help.

The website is created with HUGO, you'll need to download and install that if you want to locally work on the website. For creating new content it is not needed.

We have three types of pages.

  • Home - themes/coredns/layouts/index.html
  • Blog/News/Documentation - content/blog/* (depends on params, see archetypes)
  • Plugins - content/plugins/* and content/explugins/*

Any blog post you'll tag with 'stale' will pop up a warning after 9 months that the content of the post may not reflect the current workings of CoreDNS.

Releases should be tagged with 'release = "number" and data/coredns.toml should be updated with the number.

data/subtext.toml controls the buttons for "Docs", "Plugins" and "External Plugins".

Create:

  • new release: hugo new -k release blog/coredns-<number>.md
  • new blog: hugo new -k blog blog/coredns-<number>.md
  • new blog that will also be documentation: hugo new -k doc blog/coredns-<number>.md

Style

For the colors we have:

  • Dark: #280071 (40, 0, 113)
  • Middle: #5F259F (95, 37, 159)
  • Light: #8246AF (130, 70, 175)

The open source font Lato is very close to Brandon Grotesque (which is used in the logo). Try to use this for any imagery you add.

See the style directory for Libre Office Draw templates you can use.

Popup

See the top-level (i.e. not in the themes directory) layout/partials/popup.html for adjusting the text. This can used for important notifications.

Corefile Snippets

Any Corefile snippets should be use the (fake) language corefile, we have a small utility that checks all these snippets to see if they are still valid.

New CoreDNS releases

  • Sync the notes from the official coredns/coredns repo into this repo by running: make PLUGINDIR=~coredns/plugin sync
  • This should update the releases notes in content/blob/coredns-<version>.
  • After this step you should manually (never got this to automatically to work) update date/coredns.toml and set the latest release in that file and then run make old to update the old(er) HUGO site.