Skip to main content

Write Markdown and have it published and hosted on Cloudflare Workers

Project description

Workdown

A system to write Markdown and have it published and hosted via Cloudflare Workers

Pre-requisites

Usage

  1. pip3 install workdown
  2. Run wrangler generate site https://github.com/eldridgea/workdown-example-site. This will generate a folder called site containing the folder structure workdown requires to work.
  3. Configure wrangler.toml with your Cloudflare details, make sure your route ends in a wildcard e.g. route = "https://example.com/*".
  4. Create a KV Namespace and bind in to pages in your wrangler.toml file.
  5. Make a markdown file ending in .md in the content/ directory If you want it to be your main page, name it index.md.
  6. From the site folder (or whatever you named it) run workdown
  7. Done!

CSS

CSS should go in the assets/ directory. They will be available as their full filename under css. For example if you make main.css, it will be example.com/css/main.css

Partials

Here is where you can customize the header and footer of pages in HTML. Currently all partials apply to all pages generated. Good things to do here would be if you have a static CSS file in css/ or would like to include a a fonts CDN, add it into the <head> in the partials/header.html so it will be usable on your pages.

Notes

The path for content will be the name of the markdown file with no extension. For example if you make contact.md, it will be example.com/contact.

Install directly from Github

pip3 install git+https://github.com/eldridgea/workdown

Manual Install

  1. git clone https://github.com/eldridgea/workdown
  2. cd workdown
  3. python3 setup.py install

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

workdown-0.0.4.tar.gz (2.9 kB view details)

Uploaded Source

Built Distribution

workdown-0.0.4-py3-none-any.whl (3.5 kB view details)

Uploaded Python 3

File details

Details for the file workdown-0.0.4.tar.gz.

File metadata

  • Download URL: workdown-0.0.4.tar.gz
  • Upload date:
  • Size: 2.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.15.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.1

File hashes

Hashes for workdown-0.0.4.tar.gz
Algorithm Hash digest
SHA256 7d9af359e67c10cebac1bc1fba013d531f14c3af058f109a1fb41bdddeb24683
MD5 dee52b358e539e7faefca40db16db8bc
BLAKE2b-256 b2899b54a6697e2bcbc577931f2d49d581a3e3013cf08306bea3b18569aa028c

See more details on using hashes here.

File details

Details for the file workdown-0.0.4-py3-none-any.whl.

File metadata

  • Download URL: workdown-0.0.4-py3-none-any.whl
  • Upload date:
  • Size: 3.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.15.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.1

File hashes

Hashes for workdown-0.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 20e35b1ab96ba2cddfcd689c089c6c4aa407c3de6491f57ef1609b1e366d6d91
MD5 55e172990e046a0c2018117ce672a449
BLAKE2b-256 2b0994008920331c5eac292fef054d91cc841b7f301480bf47c253458e314fb5

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page