drafts
allows you take an in-progress Distill article submission and host it on drafts.distill.pub
. To use it, you just add the Github bot account distillpub-reviewers
as a collaborator of your repository.
Continuous integration with https://drafts.distill.pub
If your repository is hosted by an organization account, you can give the bot account admin access and it will automatically install webhooks that trigger a redeploy when you push changes.
If repository is hosted by a personal account for your repository, drafts will attempt to rebuild your submission once a day. Alternatively you can contact Distill to ask for a repository under the distillpub
Github organization.
We don't offer truly secure password protected hosting at the moment, but if you'd like to send a strong social cue not to share your WIP, you can add a password
parameter in your articles front-matter
metadata, like so:
<d-front-matter>
<script type="text/json">{
"title": "Example Distill Submission",
"password": "example-password",
"authors": […]
}</script>
</d-front-matter>
This will add a UI overlay with a password prompt:
You only need to enter this password once per browser that you use to access the article.
You should not have to interact with draft's build system during normal operation. If anything doesn't behave as you think it should, you can try these approaches:
- Check the Travis build status. You can search for your repository name to potentially learn what's failing.
- Empty the build cache (under
More Options
>Caches
) - Request a new build (under
More Options
>Trigger build
)
If you've tried these steps already, you may want to post in the Distill Slack Community in the #help
channel.
This project is research code. It is not an official product of Google or any other institution supporting Distill.
Copyright 2018, The Distill Drafts Authors.
Licensed under the Apache License, Version 2.0
See the full license.