summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/api/swagger.yaml14
-rw-r--r--docs/overrides/public/user-settings-layout-gallery.pngbin0 -> 969869 bytes
-rw-r--r--docs/overrides/public/user-settings-layout-microblog.pngbin0 -> 811730 bytes
-rw-r--r--docs/user_guide/settings.md24
4 files changed, 38 insertions, 0 deletions
diff --git a/docs/api/swagger.yaml b/docs/api/swagger.yaml
index ce415784a..1a96b0f65 100644
--- a/docs/api/swagger.yaml
+++ b/docs/api/swagger.yaml
@@ -179,6 +179,13 @@ definitions:
description: The default posting content type for new statuses.
type: string
x-go-name: StatusContentType
+ web_layout:
+ description: |-
+ Layout to use for the web view of the account.
+ "microblog": default, classic microblog layout.
+ "gallery": gallery layout with media only.
+ type: string
+ x-go-name: WebLayout
web_visibility:
description: |-
Visibility level(s) of posts to show for this account via the web api.
@@ -4902,6 +4909,13 @@ paths:
in: formData
name: web_visibility
type: string
+ - description: |-
+ Layout to use for the web view of the account.
+ "microblog": default, classic microblog layout.
+ "gallery": gallery layout with media only.
+ in: formData
+ name: web_layout
+ type: string
- description: Name of 1st profile field to be added to this account's profile. (The index may be any string; add more indexes to send more fields.)
in: formData
name: fields_attributes[0][name]
diff --git a/docs/overrides/public/user-settings-layout-gallery.png b/docs/overrides/public/user-settings-layout-gallery.png
new file mode 100644
index 000000000..75a57f8e5
--- /dev/null
+++ b/docs/overrides/public/user-settings-layout-gallery.png
Binary files differ
diff --git a/docs/overrides/public/user-settings-layout-microblog.png b/docs/overrides/public/user-settings-layout-microblog.png
new file mode 100644
index 000000000..a573e327b
--- /dev/null
+++ b/docs/overrides/public/user-settings-layout-microblog.png
Binary files differ
diff --git a/docs/user_guide/settings.md b/docs/user_guide/settings.md
index 590b04b42..3d7bd811c 100644
--- a/docs/user_guide/settings.md
+++ b/docs/user_guide/settings.md
@@ -31,6 +31,30 @@ To choose a theme, just select it from the profile settings page, and click/tap
!!! tip "Adding more themes"
Instance admins can add more themes by dropping css files into the `web/assets/themes` folder. See the [themes](../admin/themes.md) part of the admin docs for more information.
+### Select Layout
+
+GoToSocial lets you choose from two different layouts for the web view of your profile.
+
+The setting does not affect how the API behaves or how client applications look or work, it's purely a cosmetic change for the web view.
+
+In both cases, only top-level posts (or media from top-level posts) is shown, not replies or boosts, and the [Visibility Level of Posts to Show on Your Profile](#visibility-level-of-posts-to-show-on-your-profile) setting is respected.
+
+#### Microblog
+
+The GtS classic microblog layout. Your profile is split into two columns with your bio and recent/pinned posts.
+
+This is a good choice if you primarily post text, or a mixture of text and media.
+
+![Microblog layout](../public/user-settings-layout-microblog.png)
+
+#### Gallery
+
+'Gram-style layout. Posts are not shown directly on your profile. Instead, your recent/pinned media is shown in a gallery grid view. Posts (with their replies) can still be accessed via link.
+
+This is a good choice if you primarily post media.
+
+![Gallery layout](../public/user-settings-layout-gallery.png)
+
### Basic Information
#### Display Name