A Platypub theme, derived from the publishing platform's default theme in support of building a community website around a local park. It's at an early stage, like Platypub itself. Significant breaking changes should be expected as we keep pace with changes to the default theme.
Configuration for Event items is an enhancement implemented in Jackies theme and not included in the default theme.
Platypub default theme instructions:
Must have bb on path.
Within Platypub, you'll want to have at least one site, newsletter, and post.
Tags are used to specify which sites, newsletters, and posts go together. For
experimenting, you could create one of each and assign them all a tag of
example-site.
For using this theme as-is, you'll also want to create three additional special posts:
- One with
example-site welcomefor the tags. The contents of this post will be emailed to new subscribers. - One with
example-site pagefor the tags andsubscribedfor the slug. This page will be rendered athttp://localhost:8888/subscribed/and will be shown to new subscribers. It should say something like "check your inbox for a welcome email." - One with
example-site pagefor the tags andaboutfor the slug. This will be linked to from the default site's nav bar.
Make your own theme by copying this folder, e.g. cp -r themes/default themes/mytheme. Then go to your site and newsletter in Platypub and change the
theme to mytheme (or whatever you called the directory).
Run Platypub, go to the Sites tab, click "preview." Edit theme files, save, and refresh the page to make changes. Note that the newsletter signup form will not work; to test that you'll need to use option 2.
- Go to the Sites page on Platypub and click "export" to download an
input.ednfile. Copy it to this directory. - Run
bb dev
This will open a browser tab to localhost:8888 with your site. Whenever you
save a file, the site will be regenerated. You'll need to hit refresh in the
browser tab manually.
If you want to update the site/newsletter/post data, you'll need to export the
input.edn file again.
Run Platypub, make a post and open it, click "send", then click "preview." Email clients are finnicky, so be sure to send a test email at least to GMail.