summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAndrew Godwin2022-11-23 17:14:04 -0700
committerAndrew Godwin2022-11-23 17:14:04 -0700
commit8aae72998d55e9056baf5a6328d432fd7768beaa (patch)
tree2ec69b06ba4285d948121be9bd6d7006b97653d4
parente18f2879fc4f427b1fde80e18fb65a90eeaef659 (diff)
downloadtakahe-8aae72998d55e9056baf5a6328d432fd7768beaa.tar.gz
takahe-8aae72998d55e9056baf5a6328d432fd7768beaa.tar.bz2
takahe-8aae72998d55e9056baf5a6328d432fd7768beaa.zip
Style docs nicer
-rw-r--r--README.md97
-rw-r--r--docs/_templates/extralinks.html7
-rw-r--r--docs/conf.py11
3 files changed, 31 insertions, 84 deletions
diff --git a/README.md b/README.md
index cfb4900..84ca0b0 100644
--- a/README.md
+++ b/README.md
@@ -1,100 +1,31 @@
![takahē](static/img/logo-128.png)
An *experimental* Fediverse server for microblogging/"toots". Not fully functional yet -
-I'm still working on making all the basic bits work! For more background and information,
-see [jointakahe.org](https://jointakahe.org/).
+we're still working towards a 1.0!
+Key features:
+- Multiple domain support
+- Multiple identities per user (and can be shared between users)
+- Desktop, mobile and PWA-compatible web UI (with minimal JavaScript)
+- Easy deployment (web worker, background worker, and one database)
-## Deployment
-
-See [the documentation](https://takahe-server.readthedocs.io)
-
-## Roadmap
+For more background and information, see [jointakahe.org](https://jointakahe.org/).
-Takahē is still under very active development towards something I'm willing to
-call a beta. I've grouped features here into milestones, along with if they're
-done yet or not. None of this is final, and the further into the future it is,
-the less sure I am about it.
-### Alpha
-
-- [x] Create posts
-- [x] Set post visibility
-- [x] Receive posts
-- [x] Handle received post visibility (unlisted vs public only)
-- [x] Receive post deletions
-- [x] Receive post edits
-- [x] Set content warnings on posts
-- [x] Show content warnings on posts
-- [x] Receive images on posts
-- [x] Receive reply info
-- [x] Create boosts
-- [x] Receive boosts
-- [x] Create likes
-- [x] Receive likes
-- [x] Create follows
-- [x] Undo follows
-- [x] Receive and accept follows
-- [x] Receive follow undos
-- [x] Do outgoing mentions properly
-- [x] Home timeline (posts and boosts from follows)
-- [x] Notifications page (followed, boosted, liked)
-- [x] Local timeline
-- [x] Federated timeline
-- [x] Profile pages
-- [x] Settable icon and background image for profiles
-- [x] User search
-- [x] Following page
-- [x] Followers page
-- [x] Multiple domain support
-- [x] Multiple identity support
-- [x] Serverless-friendly worker subsystem
-- [x] Settings subsystem
-- [x] Server management page
-- [x] Domain management page
-- [x] Email subsystem
-- [x] Signup flow
-- [x] Password reset flow
+## Deployment
-### Beta
+See [our deployment documentation](https://takahe-server.readthedocs.io/en/latest/installation/)
-- [ ] Attach images to posts
-- [ ] Edit posts
-- [ ] Delete posts
-- [ ] Password change flow
-- [ ] Fetch remote post images locally and thumbnail
-- [ ] Show follow pending states
-- [ ] Manual approval of followers
-- [ ] Reply threading on post creation
-- [ ] Display posts with reply threads
-- [ ] Create polls on posts
-- [ ] Receive polls on posts
-- [ ] Emoji fetching and display
-- [ ] Emoji creation
-- [ ] Image descriptions
-- [ ] Hashtag search
-- [ ] Flag for moderation
-- [ ] Moderation queue
-- [ ] User management page
-- [ ] Server defederation
-- [ ] Filters for posts/boosts
-- [ ] OAuth subsystem
-### 1.0
+## Roadmap
-- [ ] IP banning
-- [ ] Trends subsystem and moderation
-- [ ] Server announcements
-- [ ] Automated post deletion
-- [ ] Post popularity system (for long gaps between timeline views)
-- [ ] Mastodon client API
+Takahē is still under very active development towards a 1.0 release, and not
+all functionality is supported yet.
-### Future
+For a detailed feature breakdown, see [the features page in our docs](https://takahe-server.readthedocs.io/en/latest/features/).
-- [ ] Relays?
-- [ ] Mastodon backup import? (would need url mapping for actors)
## Contributing
-If you'd like to contribute, please read [CONTRIBUTING.md](./CONTRIBUTING.md).
+If you'd like to contribute, please read [our contributing docs](https://takahe-server.readthedocs.io/en/latest/contributing/).
diff --git a/docs/_templates/extralinks.html b/docs/_templates/extralinks.html
new file mode 100644
index 0000000..e8a0f35
--- /dev/null
+++ b/docs/_templates/extralinks.html
@@ -0,0 +1,7 @@
+<h3>Takahē</h3>
+<ul>
+ <li><a href="https://jointakahe.org">Homepage</a></li>
+ <li><a href="https://takahe-server.readthedocs.io/">Documentation</a></li>
+ <li><a href="https://github.com/jointakahe/takahe">GitHub</a></li>
+ <li><a href="https://discord.gg/qvQ39tAMvf">Discord</a></li>
+</ul>
diff --git a/docs/conf.py b/docs/conf.py
index 73e4692..480b95b 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -22,5 +22,14 @@ exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
# -- Options for HTML output -------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
-html_theme = "alabaster"
+html_theme = "nature"
html_static_path = ["_static"]
+html_logo = "../static/img/logo-128.png"
+html_favicon = "../static/img/icon-32.png"
+html_sidebars = {
+ "**": [
+ "localtoc.html",
+ "extralinks.html",
+ "searchbox.html",
+ ]
+}