Merge branch 'develop' into default-db-name
[akkoma] / docs / configuration / static_dir.md
index 8e7eea7fb21d7f941c85ac549093f2bd83b18308..37e07eb0d225e107cb9b4736ec8774a5c595d77b 100644 (file)
@@ -1,18 +1,22 @@
 # Static Directory
 
-Static frontend files are shipped with pleroma. If you want to overwrite or update these without problems during upgrades, you can write your custom versions to the static directory.
+Static frontend files are shipped with Akkoma. If you want to overwrite or update these without problems during upgrades, you can write your custom versions to the static directory.
 
 You can find the location of the static directory in the [configuration](../cheatsheet/#instance).
 
-```elixir tab="OTP"
-config :pleroma, :instance,
-  static_dir: "/var/lib/pleroma/static/",
-```
+=== "OTP"
 
-```elixir tab="From Source"
-config :pleroma, :instance,
-  static_dir: "instance/static/",
-```
+    ```elixir
+    config :pleroma, :instance,
+      static_dir: "/var/lib/akkoma/static/"
+    ```
+
+=== "From Source"
+
+    ```elixir
+    config :pleroma, :instance,
+    static_dir: "instance/static/"
+    ```
 
 Alternatively, you can overwrite this value in your configuration to use a different static instance directory.
 
@@ -26,7 +30,7 @@ There's a mix tasks to [generate a new robot.txt](../../administration/CLI_tasks
 
 For more complex things, you can write your own robots.txt to `$static_dir/robots.txt`.
 
-E.g. if you want to block all crawerls except for [fediverse.newtork](https://fediverse.network/about) you can use
+E.g. if you want to block all crawlers except for [fediverse.network](https://fediverse.network/about) you can use
 
 ```
 User-Agent: *
@@ -45,11 +49,11 @@ Add `$static_dir/instance/thumbnail.jpeg` with your selfie or other neat picture
 
 ## Instance-specific panel
 
-Create and Edit your file on `$static_dir/instance/panel.html`.
+Create and Edit your file at `$static_dir/instance/panel.html`.
 
 ## Background
 
-You can change the background of your Pleroma instance by uploading it to `$static_dir/`, and then changing `background` in [your configuration](../cheatsheet/#frontend_configurations) accordingly.
+You can change the background of your Akkoma instance by uploading it to `$static_dir/`, and then changing `background` in [your configuration](../cheatsheet/#frontend_configurations) accordingly.
 
 E.g. if you put `$static_dir/images/background.jpg`
 
@@ -84,3 +88,8 @@ config :pleroma, :frontend_configurations,
     Note the extra `static` folder for the terms-of-service.html
 
 Terms of Service will be shown to all users on the registration page. It's the best place where to write down the rules for your instance. You can modify the rules by adding and changing `$static_dir/static/terms-of-service.html`.
+
+       
+## Styling rendered pages
+
+To overwrite the CSS stylesheet of the OAuth form and other static pages, you can upload your own CSS file to `instance/static/static.css`. This will completely replace the CSS used by those pages, so it might be a good idea to copy the one from `priv/static/instance/static.css` and make your changes.