Skip to content

Commit

Permalink
update feed & list docs
Browse files Browse the repository at this point in the history
  • Loading branch information
navix committed Oct 24, 2024
1 parent d85d80d commit 8650851
Show file tree
Hide file tree
Showing 17 changed files with 138 additions and 6 deletions.
4 changes: 2 additions & 2 deletions astro.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ import starlight from '@astrojs/starlight';
export default defineConfig({
integrations: [
starlight({
customCss: ['./src/styles/theme.css'],
customCss: ['./src/styles/theme.css', './src/styles/common.css'],
title: 'База знань Bluesky',
defaultLocale: 'root',
locales: {
Expand All @@ -24,7 +24,6 @@ export default defineConfig({
},
sidebar: [
{
label: 'Home',
slug: 'home',
},
{
Expand All @@ -36,6 +35,7 @@ export default defineConfig({
{slug: 'basics/public'},
{slug: 'basics/handle'},
{slug: 'basics/feed'},
{slug: 'basics/list'},
{slug: 'basics/mute'},
{slug: 'basics/block'},
],
Expand Down
Binary file added public/images/feed-search.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/images/feeds-discover.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/images/feeds-in-profile.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/images/feeds-list.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/images/feeds-pin.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/images/feeds-pin2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/images/feeds-unpin.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/images/list-add.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/images/list-add2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/images/list-del.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/images/list-new-mod.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/images/list-new.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/images/list-profile.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
56 changes: 52 additions & 4 deletions src/content/docs/basics/feed.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,63 @@ title: Стрічки (feed)

import {Aside} from '@astrojs/starlight/components';

Замість одного алгоритму, який вибирає пости для вас, ви маєте вибір з багатьох алгоритмів.
Замість одного алгоритму, який вибирає пости для вас, ви маєте вибір з багатьох алгоритмів і джерел контенту.

На головній сторінці першою йде стрічка Following (пости тих, кого ви фоловите), а всі інші стрічки вибираєте ви.
На головній сторінці першою йде стрічка **Following** (пости тих, кого ви фоловите), а всі інші стрічки вибираєте ви.

Будь хто може створити свою стрічку і сам визначати, які пости в ній будуть.
Відповідно є 2 додаткових види стрічок: алгоритмічні, зі списків.

Знайти нові стрічки можна у [відповідному розділі додатку](https://bsky.app/feeds).
## Алгоритмічні стрічки (фіди)

Пости в них обираються за правилами, які створює автор.

_Наприклад, є стрічки з котами, новинами або срачами - політ фантазії не обмежений._

Ви також можете створити свою стрічку, більше про це у [розділі **Створення стрічки**](../guides/custom-feed).

### Пошук стрічок

Знайти їх можна у [розділі меню **Стрічки**](https://bsky.app/feeds), нижче блоку **Мої стрічки**.

<img src="/images/feeds-discover.png" class="app-left-center" />

Або у розділі **Пошук** введіть пошуковий рядок, натисність Enter та виберіть вкладку **Стрічки**.

<img src="/images/feed-search.png" class="app-center" />

### Стрічки у профілях

У кожної стрічки є автор, відповідно на сторінці профіля можна знайти стрічки, які вони створили.

<img src="/images/feeds-in-profile.png" class="app-center" />

<Aside type="tip">
У **@bsky.one** також є стрічки з контентом від українських профілів. Їх можна знайти у [нашому профілі
@bsky.one](https://bsky.app/profile/bsky.one), на вкладці Стрічки (Feeds).
</Aside>

## Стрічки зі списків

Стрічки зі списків показують пости від профілів, яких додали до [списку](./list).

<img src="/images/feeds-list.png" class="app-center" />

## Закріплення стрічки

Якщо вам подобається стрічка, ви можете закріпити її у **Мої стрічки**.

<img src="/images/feeds-pin.png" class="app-center" />

Після цього вона з'явиться у правому меню та у верхній каруселі на головній сторінці.

<img src="/images/feeds-pin2.png" class="app-full" />

Те саме стосується стрічок зі списків.

## Відкріплення стрічки

Щоб видалити стрічку зі списку **Мої стрічки**, зайдіть у розділ **Стрічки** у меню,
знайдіть потрібну стрічку на натисніть неї і на наступному екрані натисність **Відкріпити**
у верхньому правому кутку.

<img src="/images/feeds-unpin.png" class="app-center" />
67 changes: 67 additions & 0 deletions src/content/docs/basics/list.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
---
title: Списки (list)
description: Як працюють списки в Bluesky?
---

import {Aside, Steps} from '@astrojs/starlight/components';

Списки дозволяють групувати профілі для подальшого використання.

Ви можете створювати власні списки та додавати до них профілі. Або використовувати списки інших користувачів.

Є 2 види списків: звичайні та для модерації.

## Звичайні списки

Звичайні списки можуть бути використані для групування профілів і перегляду [стрічки](/basics/feed) їх постів.

Стрічку постів зі звичайного списку також можна [закріпити у **Мої стрічки**](/basics/feed#закріплення-стрічки).

### Створення звичайного списку

Перейдіть у розділ **Списки** у меню і натисність **+ Новий** у верхньому правому кутку.

<img src="/images/list-new.png" class="app-left-center" />

Після заповнення форми список буде створено.

## Списки для модерації

Списки для модерації можуть бути використані для [блокування](/basics/block) або [ігнорування](/basics/mute) групи профілів.

### Створення списку для модерації

Перейдіть у **Налаштування** &rarr; **Модерація** &rarr; **Списки для модерації** і натисніть **+ Новий** у верхньому правому кутку.

<img src="/images/list-new-mod.png" class="app-center" />

## Додавання профілів

Додати профіль у список можна зі сторінки профілю.

<img src="/images/list-add.png" class="app-left-center" />

Або на вкладці **About** самого списку.

<img src="/images/list-add2.png" class="app-center" />

## Видалення списку

Щоб видалити список, перейдіть на сторінку самого списку та натисніть **Видалити** у верхньому правому меню.

<img src="/images/list-del.png" class="app-left-center" />

## Перегляд списків

Ви можете переглядати списки інших користувачів, на сторінці профілю.

<img src="/images/list-profile.png" class="app-center" />

<Aside type="tip">
Наприклад, профіль [@mods.mobik.zip](https://bsky.app/profile/mods.mobik.zip) веде списки росіян, вестплейнерів та
інших персонажів, яких варто блокувати.
</Aside>

## Пошук списків

Наразі пошук списків через застосунок не реалізовано.
17 changes: 17 additions & 0 deletions src/styles/common.css
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
.sl-markdown-content img {
border-radius: 0.5rem;
max-width: min(48rem, 100%);
margin: 1rem auto;
}

.sl-markdown-content img.app-center {
max-width: 24rem;
}

.sl-markdown-content img.app-left-center {
max-width: 32rem;
}

.sl-markdown-content img.app-full {
max-width: min(48rem, 100%);
}

0 comments on commit 8650851

Please sign in to comment.