Skip to content
This repository has been archived by the owner on Jan 9, 2021. It is now read-only.

vipickering/mastr-cntrl

Repository files navigation

About

Mastr Cntrl is a part of a Microservices suite of IndieWeb tools.

  • Mastr Cntrl is the Microservice responsible for recieving Micropub and social content.
  • MC Webmention is the webmention service. Designed to send and recieve Webmentions.
  • MC Syndication is the syndication service. Designed to syndicate content to other platforms.

Purpose

The service: - Recieves Micropub content, and transform the JSON in to a Markdown file with associated frontmatter. - POST's transformed content in to a Github Repo (via the API) to a designated location. - Recieves Media content and POST in to a Github Repo (via the API) to a designated location. - Recieves 3rd party Social content (in development at the moment).

Install

  1. Download the content and install with npm install.
  2. Create your .env file and use the sample.env as your guide.
  3. Run with npm start

Dependencies

Timezone

You will need to specify your timezone using this timezone list in the .env file. Use the sample.env as your guide.

The timezone is used to generate the blog post frontmatter and is also used on my blog to generate URLs. You may also do the same, so I recommend setting it to a 24 local timezone to avoid clashes in a 12 hour period or to avoid posts published at random times, instead of your local time.

It is also advantageous to do this so you are not constrained where you host Mastr-Cntrl. You can host it in one part of the world and post using your local time if you like.

Optional extras

Slack

If you wish to use additional Slack logging:

  1. Create an 'Incoming WebHooks app', over on Slack.
  2. Copy the webhook key., generated.
  3. Paste the key in to your .env file following the sample.env file as a guide.

Syndicating to Twitter

Mastr-Cntrl doesn't syndicate to Twitter (but mc-syndication does). However if you are creating a Micropub post and wish to syndicate to Twitter, the Micropub client needs to know your Twitter details, so they can be saved alongside the post in the frontmatter.

Add your twitter username in the .env file following the sample.env file as a guide and it will appear in the micropub client as an option.