writefreely/README.md

95 lines
5.1 KiB
Markdown
Raw Normal View History

 
<p align="center">
2019-04-12 03:33:33 +02:00
<a href="https://writefreely.org"><img src="https://writefreely.org/img/writefreely.svg" width="350px" alt="WriteFreely" /></a>
</p>
<hr />
<p align="center">
2018-10-17 04:51:42 +02:00
<a href="https://github.com/writeas/writefreely/releases/">
<img src="https://img.shields.io/github/release/writeas/writefreely.svg" alt="Latest release" />
</a>
2018-11-08 07:55:50 +01:00
<a href="https://goreportcard.com/report/github.com/writeas/writefreely">
<img src="https://goreportcard.com/badge/github.com/writeas/writefreely" alt="Go Report Card" />
</a>
2018-10-17 04:51:42 +02:00
<a href="https://travis-ci.org/writeas/writefreely">
<img src="https://travis-ci.org/writeas/writefreely.svg" alt="Build status" />
</a>
<a href="https://github.com/writeas/writefreely/releases/latest">
<img src="https://img.shields.io/github/downloads/writeas/writefreely/total.svg" />
</a>
<a href="https://hub.docker.com/r/writeas/writefreely/">
<img src="https://img.shields.io/docker/pulls/writeas/writefreely.svg" />
2018-11-12 00:37:13 +01:00
</a>
</p>
2018-10-17 04:39:46 +02:00
&nbsp;
2018-01-25 01:52:16 +01:00
2018-10-17 04:39:46 +02:00
WriteFreely is a beautifully pared-down blogging platform that's simple on the surface, yet powerful underneath.
2018-01-25 01:52:16 +01:00
2018-11-21 17:54:01 +01:00
It's designed to be flexible and share your writing widely, so it's built around plain text and can publish to the _fediverse_ via ActivityPub. It's easy to install and light enough to run on a Raspberry Pi.
2018-01-25 01:52:16 +01:00
2018-11-10 22:19:05 +01:00
[Try the editor](https://write.as/new)
2019-01-24 22:36:58 +01:00
[Find an instance](https://writefreely.org/instances)
2018-11-08 07:55:50 +01:00
2018-01-25 01:52:16 +01:00
## Features
* Start a blog for yourself, or host a community of writers
* Form larger federated networks, and interact over modern protocols like ActivityPub
* Write on a fast, dead-simple, and distraction-free editor
* [Format text](https://howto.write.as/getting-started) with Markdown
* [Organize posts](https://howto.write.as/organization) with hashtags
* Create [static pages](https://howto.write.as/creating-a-static-page)
2018-11-08 07:55:50 +01:00
* Publish drafts and let others proofread them by sharing a private link
* Create multiple lightweight blogs under a single account
* Export all data in plain text files
* Read a stream of other posts in your writing community
2018-10-17 04:39:46 +02:00
* Build more advanced apps and extensions with the [well-documented API](https://developers.write.as/docs/api/)
* Designed around user privacy and consent
2018-01-25 01:52:16 +01:00
2019-01-24 22:35:04 +01:00
## Hosting
We offer two kinds of hosting services that make WriteFreely deployment painless: [Write.as](https://write.as) for individuals, and [WriteFreely.host](https://writefreely.host) for communities. Besides saving you time, as a customer you directly help fund WriteFreely development.
### [![Write.as](https://write.as/img/writeas-wf-readme.png)](https://write.as/)
2019-01-25 03:11:04 +01:00
Start a personal blog on [Write.as](https://write.as), our flagship instance. Built to eliminate setup friction and preserve your privacy, Write.as helps you start a blog in seconds. It supports custom domains (with SSL) and multiple blogs / pen names per account. [Read more here](https://write.as/pricing).
2019-01-24 22:35:04 +01:00
### [![WriteFreely.host](https://writefreely.host/img/wfhost-wf-readme.png)](https://writefreely.host)
[WriteFreely.host](https://writefreely.host) makes it easy to start a close-knit community — to share knowledge, complement your Mastodon instance, or publish updates in your organization. We take care of the hosting, upgrades, backups, and maintenance so you can focus on writing.
2018-11-08 07:34:23 +01:00
## Quick start
WriteFreely has minimal requirements to get up and running — you only need to be able to run an executable.
2018-11-10 22:19:05 +01:00
> **Note** this is currently alpha software. We're quickly moving out of this v0.x stage, but while we're in it, there are no guarantees that this is ready for production use.
To get started, head over to our [Getting Started guide](https://writefreely.org/start). For production use, jump to the [Running in Production](https://writefreely.org/start#production) section.
2018-11-10 22:33:56 +01:00
2018-12-01 16:13:45 +01:00
## Packages
WriteFreely is available in these package repositories:
* [Arch User Repository](https://aur.archlinux.org/packages/writefreely/)
## Documentation
Read our full [documentation on WriteFreely.org](https://writefreely.org/docs). Help us improve by contributing to the [writefreely/documentation](https://github.com/writefreely/documentation) repo.
2018-11-08 07:34:23 +01:00
## Development
Ready to hack on your site? Get started with our [developer guide](https://writefreely.org/docs/latest/developer/setup).
2018-11-08 07:34:23 +01:00
## Docker
Read about using Docker in the [documentation](https://writefreely.org/docs/latest/admin/docker).
2018-11-21 17:54:01 +01:00
## Contributing
2019-01-27 03:25:38 +01:00
We gladly welcome contributions to WriteFreely, whether in the form of [code](https://github.com/writeas/writefreely/blob/master/CONTRIBUTING.md#contributing-to-writefreely), [bug reports](https://github.com/writeas/writefreely/issues/new?template=bug_report.md), [feature requests](https://discuss.write.as/c/feedback/feature-requests), [translations](https://poeditor.com/join/project/TIZ6HFRFdE), or [documentation](https://github.com/writefreely/documentation) improvements.
2018-11-21 17:54:01 +01:00
Before contributing anything, please read our [Contributing Guide](https://github.com/writeas/writefreely/blob/master/CONTRIBUTING.md#contributing-to-writefreely). It describes the correct channels for submitting contributions and any potential requirements.
2018-01-25 01:52:16 +01:00
## License
2018-10-29 15:06:45 +01:00
Licensed under the AGPL.