## File: README.md

## About The Project

| Desktop                                                      | Mobile                                                   |
| ------------------------------------------------------------ | -------------------------------------------------------- |
|  |  |

[Lemmy](https://github.com/LemmyNet/lemmy) is similar to sites like [Reddit](https://reddit.com), [Lobste.rs](https://lobste.rs), or [Hacker News](https://news.ycombinator.com/): you subscribe to forums you're interested in, post links and discussions, then vote, and comment on them. Behind the scenes, it is very different; anyone can easily run a server, and all these servers are federated (think email), and connected to the same universe, called the [Fediverse](https://en.wikipedia.org/wiki/Fediverse).

For a link aggregator, this means a user registered on one server can subscribe to forums on any other server, and can have discussions with users registered elsewhere.

It is an easily self-hostable, decentralized alternative to Reddit and other link aggregators, outside of their corporate control and meddling.

Each Lemmy server can set its own moderation policy; appointing site-wide admins, and community moderators to keep out the trolls, and foster a healthy, non-toxic environment where all can feel comfortable contributing.

### Why's it called Lemmy?

- Lead singer from [Motörhead](https://invidio.us/watch?v=3mbvWn1EY6g).
- The old school [video game](<https://en.wikipedia.org/wiki/Lemmings_(video_game)>).
- The [Koopa from Super Mario](https://www.mariowiki.com/Lemmy_Koopa).
- The [furry rodents](http://sunchild.fpwc.org/lemming-the-little-giant-of-the-north/).

### Built With

- [Rust](https://www.rust-lang.org)
- [Actix](https://actix.rs/)
- [Diesel](http://diesel.rs/)
- [Inferno](https://infernojs.org)
- [Typescript](https://www.typescriptlang.org/)

## Features

- Open source, [AGPL License](/LICENSE).
- Self hostable, easy to deploy.
  - Comes with [Docker](https://join-lemmy.org/docs/administration/install_docker.html) and [Ansible](https://join-lemmy.org/docs/administration/install_ansible.html).
- Clean, mobile-friendly interface.
  - Only a minimum of a username and password is required to sign up!
  - User avatar support.
  - Live-updating Comment threads.
  - Full vote scores `(+/-)` like old Reddit.
  - Themes, including light, dark, and solarized.
  - Emojis with autocomplete support. Start typing `:`
  - User tagging using `@`, Community tagging using `!`.
  - Integrated image uploading in both posts and comments.
  - A post can consist of a title and any combination of self text, a URL, or nothing else.
  - Notifications, on comment replies and when you're tagged.
    - Notifications can be sent via email.
    - Private messaging support.
  - i18n / internationalization support.
  - RSS / Atom feeds for `All`, `Subscribed`, `Inbox`, `User`, and `Community`.
- Cross-posting support.
  - A _similar post search_ when creating new posts. Great for question / answer communities.
- Moderation abilities.
  - Public Moderation Logs.
  - Can sticky posts to the top of communities.
  - Both site admins, and community moderators, who can appoint other moderators.
  - Can lock, remove, and restore posts and comments.
  - Can ban and unban users from communities and the site.
  - Can transfer site and communities to others.
- Can fully erase your data, replacing all posts and comments.
- NSFW post / community support.
- High performance.
  - Server is written in rust.
  - Supports arm64 / Raspberry Pi.

## Installation

- [Lemmy Administration Docs](https://join-lemmy.org/docs/administration/administration.html)

## Lemmy Projects

- [awesome-lemmy - A community driven list of apps and tools for lemmy](https://github.com/dbeley/awesome-lemmy)

## Support / Donate

Lemmy is free, open-source software, meaning no advertising, monetizing, or venture capital, ever. Your donations directly support full-time development of the project.

Lemmy is made possible by a generous grant from the [NLnet foundation](https://nlnet.nl/).

- [Support on Liberapay](https://liberapay.com/Lemmy).
- [Support on Ko-fi](https://ko-fi.com/lemmynet).
- [Support on OpenCollective](https://opencollective.com/lemmy).
- [Support on Patreon](https://www.patreon.com/dessalines).

### Crypto

- bitcoin: `1Hefs7miXS5ff5Ck5xvmjKjXf5242KzRtK`
- ethereum: `0x400c96c96acbC6E7B3B43B1dc1BB446540a88A01`
- monero: `41taVyY6e1xApqKyMVDRVxJ76sPkfZhALLTjRvVKpaAh2pBd4wv9RgYj1tSPrx8wc6iE1uWUfjtQdTmTy2FGMeChGVKPQuV`

## Contributing

Read the following documentation to setup the development environment and start coding:

- [Contributing instructions](https://join-lemmy.org/docs/contributors/01-overview.html)
- [Docker Development](https://join-lemmy.org/docs/contributors/03-docker-development.html)
- [Local Development](https://join-lemmy.org/docs/contributors/02-local-development.html)

When working on an issue or pull request, you can comment with any questions you may have so that maintainers can answer them. You can also join the [Matrix Development Chat](https://matrix.to/#/#lemmydev:matrix.org) for general assistance.

### Translations

- If you want to help with translating, take a look at [Weblate](https://weblate.join-lemmy.org/projects/lemmy/). You can also help by [translating the documentation](https://github.com/LemmyNet/lemmy-docs#adding-a-new-language).

## Community

- [Matrix Space](https://matrix.to/#/#lemmy-space:matrix.org)
- [Lemmy Forum](https://lemmy.ml/c/lemmy)
- [Lemmy Support Forum](https://lemmy.ml/c/lemmy_support)

## Code Mirrors

- [GitHub](https://github.com/LemmyNet/lemmy)
- [Codeberg](https://codeberg.org/LemmyNet/lemmy)

## Credits

Logo made by Andy Cuccaro (@andycuccaro) under the CC-BY-SA 4.0 license.

---

## File: crates/api/api_common/README.md

# lemmy_api_common

This crate provides all the data types which are necessary to build a client for [Lemmy](https://join-lemmy.org/). You can use them with the HTTP client of your choice.

Here is an example using [reqwest](https://crates.io/crates/reqwest):

```rust
    let params = GetPosts {
        community_name: Some("asklemmy".to_string()),
        ..Default::default()
    };
    let client = Client::new();
    let response = client
        .get("https://lemmy.ml/api/v4/post/list")
        .query(&params)
        .send()
        .await?;
    let json = response.json::<GetPostsResponse>().await.unwrap();
    print!("{:?}", &json);
```

As you can see, each API endpoint needs a parameter type ( GetPosts), path (/post/list) and response type (GetPostsResponse). You can find the paths and handler methods from [this file](https://github.com/LemmyNet/lemmy/blob/main/src/api_routes_http.rs). The parameter type and response type are defined on each handler method.

For a real example of a Lemmy API client, look at [lemmyBB](https://github.com/LemmyNet/lemmyBB/tree/main/src/api).

Lemmy also provides a websocket API. You can find the full websocket code in [this file](https://github.com/LemmyNet/lemmy/blob/main/src/api_routes_websocket.rs).

## Generate TypeScript bindings

TypeScript bindings (API types) can be generated by running `cargo test --features full`.
The ts files be generated into a `bindings` folder.

This crate uses [`ts_rs`](https://docs.rs/ts-rs/6.2.1/ts_rs/#traits) macros `derive(TS)` and `ts(export)` to attribute types for binding generating.

---

## File: docker/README.md

# Building Lemmy Images

Lemmy's images are meant to be **built** on `linux/amd64`,
but they can be **executed** on both `linux/amd64` and `linux/arm64`.

To do so we need to use a _cross toolchain_ whose goal is to build
**from** amd64 **to** arm64.

Namely, we need to link the _lemmy_server_ with `pq` and `openssl`
shared libraries and a few others, and they need to be in `arm64`,
indeed.

The toolchain we use to cross-compile is specifically tailored for
Lemmy's needs, see [the image repository][image-repo].

#### References

- [The Linux Documentation Project on Shared Libraries][tldp-lib]

[tldp-lib]: https://tldp.org/HOWTO/Program-Library-HOWTO/shared-libraries.html
[image-repo]: https://github.com/raskyld/lemmy-cross-toolchains

---

## File: readmes/README.es.md

## Sobre El Proyecto

| Escritorio                                                                                                      | Móvil                                                                                                       |
| --------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
|  |  |

[Lemmy](https://github.com/LemmyNet/lemmy) es similar a sitios como [Menéame](https://www.meneame.net/), [Reddit](https://reddit.com), [Lobste.rs](https://lobste.rs), [Raddle](https://raddle.me), o [Hacker News](https://news.ycombinator.com/): te subscribes a los foros que te interesan, publicas enlaces y debates, luego votas y comentas en ellos. Entre bastidores, es muy diferente; cualquiera puede gestionar fácilmente un servidor, y todos estos servidores son federados (piensa en el correo electrónico), y conectados al mismo universo, llamado [Fediverso](https://es.wikipedia.org/wiki/Fediverso).

Para un agregador de enlaces, esto significa que un usuario registrado en un servidor puede suscribirse a los foros de otro servidor, y puede mantener discusiones con usuarios registrados en otros lugares.

El objetivo general es crear una alternativa a reddit y otros agregadores de enlaces, fácilmente auto-hospedada, descentralizada, fuera de su control e intromisión corporativa.

Cada servidor lemmy puede establecer su propia política de moderación; nombrando a los administradores del sitio y a los moderadores de la comunidad para mantener alejados a los trolls, y fomentar un entorno saludable y no tóxico en el que puedan sentirse cómodos contribuyendo.

_Nota: Las APIs WebSocket y HTTP actualmente son inestables_

### ¿Por qué se llama Lemmy?

- Cantante principal de [Motörhead](https://invidio.us/watch?v=pWB5JZRGl0U).
- El [videojuego de la vieja escuela](https://es.wikipedia.org/wiki/Lemmings).
- El [Koopa de Super Mario](https://www.mariowiki.com/Lemmy_Koopa).
- Los [roedores peludos](http://sunchild.fpwc.org/lemming-the-little-giant-of-the-north/).

### Creado Con

- [Rust](https://www.rust-lang.org)
- [Actix](https://actix.rs/)
- [Diesel](http://diesel.rs/)
- [Inferno](https://infernojs.org)
- [Typescript](https://www.typescriptlang.org/)

# Características

- Código abierto, [Licencia AGPL](/LICENSE).
- Auto-hospedado, fácil de desplegar (deploy).
  - Viene con [Docker](#docker) y [Ansible](#ansible).
- Interfaz limpia y fácil de usar. Apta para dispositivos móviles.
  - Sólo se requiere como mínimo un nombre de usuario y una contraseñar para inscribirse!
  - Soporte de avatar de usuario.
  - Hilos de comentarios actualizados en directo.
  - Puntuaciones completas de los votos `(+/-)` como en el antiguo reddit.
  - Temas, incluidos los claros, los oscuros, y los solarizados.
  - Emojis con soporte de autocompletado. Empieza tecleando `:`
    - _Ejemplo_ `miau :cat:` => `miau 🐈`
  - Etiquetado de Usuarios con `@`, etiquetado de Comunidades con `!`.
    - _Ejemplo_ `@miguel@lemmy.ml me invitó a la comunidad !gaming@lemmy.ml`
  - Carga de imágenes integrada tanto en las publicaciones como en los comentarios.
  - Una publicación puede consistir en un título y cualquier combinación de texto propio, una URL o nada más.
  - Notificaciones, sobre las respuestas a los comentarios y cuando te etiquetan.
    - Las notificaciones se pueden enviar por correo electrónico.
    - Soporte para mensajes privados.
  - Soporte de i18n / internacionalización.
  - Fuentes RSS / Atom para Todo `All`, Suscrito `Subscribed`, Bandeja de entrada `inbox`, Usuario `User`, y Comunidad `Community`.
- Soporte para la publicación cruzada (cross-posting).
  - **búsqueda de publicaciones similares** al crear una nueva. Ideal para comunidades de preguntas y respuestas.
- Capacidades de moderación.
  - Registros públicos de moderación.
  - Puedes pegar las publicaciones a la parte superior de las comunidades.
  - Tanto los administradores del sitio, como los moderadores de la comunidad, pueden nombrar a otros moderadores.
  - Puedes bloquear, eliminar y restaurar publicaciones y comentarios.
  - Puedes banear y desbanear usuarios de las comunidades y del sitio.
  - Puedes transferir el sitio y las comunidades a otros.
- Puedes borrar completamente tus datos, reemplazando todas las publicaciones y comentarios.
- Soporte para publicaciones y comunidades NSFW.
- Alto rendimiento.
  - El servidor está escrito en rust.
  - El front end está comprimido (gzipped) en `~80kB`.
  - El front end funciona sin javascript (sólo lectura).
  - Soporta arm64 / Raspberry Pi.

## Instalación

- [Docker](https://join-lemmy.org/docs/es/administration/install_docker.html)
- [Ansible](https://join-lemmy.org/docs/es/administration/install_ansible.html)

## Proyectos de Lemmy

### Aplicaciones

- [lemmy-ui - La aplicación web oficial para lemmy](https://github.com/LemmyNet/lemmy-ui)
- [Lemmur - Un cliente móvil para Lemmy (Android, Linux, Windows)](https://github.com/LemmurOrg/lemmur)
- [Remmel - Una aplicación IOS nativa](https://github.com/uuttff8/Lemmy-iOS)

### Librerías

- [lemmy-js-client](https://github.com/LemmyNet/lemmy-js-client)
- [Kotlin API ( en desarrollo )](https://github.com/eiknat/lemmy-client)
- [Dart API client ( en desarrollo )](https://github.com/LemmurOrg/lemmy_api_client)

## Apoyo / Donación

Lemmy es un software libre y de código abierto, lo que significa que no hay publicidad, monetización o capital de riesgo, nunca. Tus donaciones apoyan directamente el desarrollo a tiempo completo del proyecto.

- [Apoya en Liberapay](https://liberapay.com/Lemmy).
- [Apoya en Ko-fi](https://ko-fi.com/lemmynet).
- [Apoya en Patreon](https://www.patreon.com/dessalines).
- [Apoya en OpenCollective](https://opencollective.com/lemmy).
- [Lista de patrocinadores](https://join-lemmy.org/sponsors).

### Crypto

- bitcoin: `1Hefs7miXS5ff5Ck5xvmjKjXf5242KzRtK`
- ethereum: `0x400c96c96acbC6E7B3B43B1dc1BB446540a88A01`
- monero: `41taVyY6e1xApqKyMVDRVxJ76sPkfZhALLTjRvVKpaAh2pBd4wv9RgYj1tSPrx8wc6iE1uWUfjtQdTmTy2FGMeChGVKPQuV`

## Contribuir

- [Instrucciones para contribuir](https://join-lemmy.org/docs/es/contributing/contributing.html)
- [Desarrollo por Docker](https://join-lemmy.org/docs/es/contributing/docker_development.html)
- [Desarrollo Local](https://join-lemmy.org/docs/es/contributing/local_development.html)

### Traducciones

Si quieres ayudar con la traducción, echa un vistazo a [Weblate](https://weblate.yerbamate.ml/projects/lemmy/). También puedes ayudar [traduciendo la documentación](https://github.com/LemmyNet/lemmy-docs#adding-a-new-language).

## Contacto

- [Mastodon](https://mastodon.social/@LemmyDev)
- [Matrix](https://matrix.to/#/#lemmy:matrix.org)

## Repositorios del código

- [GitHub](https://github.com/LemmyNet/lemmy)
- [Gitea](https://yerbamate.ml/LemmyNet/lemmy)
- [Codeberg](https://codeberg.org/LemmyNet/lemmy)

## Creditos

Logo hecho por Andy Cuccaro (@andycuccaro) bajo la licencia CC-BY-SA 4.0.

---

## File: readmes/README.ja.md

## プロジェクトについて

| デスクトップ                                                                                                    | モバイル                                                                                                    |
| --------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
|  |  |

[Lemmy](https://github.com/LemmyNet/lemmy) は、[Reddit](https://reddit.com)、[Lobste.rs](https://lobste.rs)、[Hacker News](https://news.ycombinator.com/) といったサイトに似ています。興味のあるフォーラムを購読してリンクや議論を掲載し、投票したり、コメントしたりしています。誰でも簡単にサーバーを運営することができ、これらのサーバーはすべて連合しており（電子メールを考えてください）、[Fediverse](https://en.wikipedia.org/wiki/Fediverse) と呼ばれる同じ宇宙に接続されています。

リンクアグリゲーターの場合、あるサーバーに登録したユーザーが他のサーバーのフォーラムを購読し、他のサーバーに登録したユーザーとディスカッションができることを意味します。

Reddit や他のリンクアグリゲーターに代わる、企業の支配や干渉を受けない、簡単にセルフホスティングできる分散型の代替手段です。

各 Lemmy サーバーは、独自のモデレーションポリシーを設定することができます。サイト全体の管理者やコミュニティモデレーターを任命し、荒らしを排除し、誰もが安心して貢献できる健全で毒気のない環境を育みます。

### なぜ Lemmy というのか？

- [Motörhead](https://invidio.us/watch?v=3mbvWn1EY6g) のリードシンガー。
- 古くは[ビデオゲーム](<https://en.wikipedia.org/wiki/Lemmings_(video_game)>)。
- [スーパーマリオのクッパ](https://www.mariowiki.com/Lemmy_Koopa)。
- [毛むくじゃらの齧歯類](http://sunchild.fpwc.org/lemming-the-little-giant-of-the-north/)。

### こちらでビルド

- [Rust](https://www.rust-lang.org)
- [Actix](https://actix.rs/)
- [Diesel](http://diesel.rs/)
- [Inferno](https://infernojs.org)
- [Typescript](https://www.typescriptlang.org/)

## 特徴

- オープンソース、[AGPL License](/LICENSE) です。
- セルフホスティングが可能で、デプロイが容易です。
  - [Docker](https://join-lemmy.org/docs/en/administration/install_docker.html) と [Ansible](https://join-lemmy.org/docs/en/administration/install_ansible.html) が付属しています。
- クリーンでモバイルフレンドリーなインターフェイス。
  - サインアップに必要なのは、最低限のユーザー名とパスワードのみ！
  - ユーザーアバター対応
  - ライブ更新のコメントスレッド
  - 古い Reddit のような完全な投票スコア `(+/-)`.
  - ライト、ダーク、ソラライズなどのテーマがあります。
  - オートコンプリートをサポートする絵文字。`:` と入力することでスタート
  - ユーザータグは `@` で、コミュニティタグは `!` で入力できます。
  - 投稿とコメントの両方で、画像のアップロードが可能です。
  - 投稿は、タイトルと自己テキスト、URL、またはそれ以外の任意の組み合わせで構成できます。
  - コメントの返信や、タグ付けされたときに、通知します。
    - 通知はメールで送ることができます。
    - プライベートメッセージのサポート
  - i18n / 国際化のサポート
  - `All`、`Subscribed`、`Inbox`、`User`、`Community` の RSS / Atom フィードを提供します。
- クロスポストのサポート。
  - 新しい投稿を作成する際の _類似投稿検索_。質問/回答コミュニティに最適です。
- モデレーション機能。
  - モデレーションのログを公開。
  - コミュニティのトップページにスティッキー・ポストを貼ることができます。
  - サイト管理者、コミュニティモデレーターの両方が、他のモデレーターを任命することができます。
  - 投稿やコメントのロック、削除、復元が可能。
  - コミュニティやサイトの利用を禁止したり、禁止を解除したりすることができます。
  - サイトとコミュニティを他者に譲渡することができます。
- すべての投稿とコメントを削除し、データを完全に消去することができます。
- NSFW 投稿/コミュニティサポート
- 高いパフォーマンス。
  - サーバーは Rust で書かれています。
  - フロントエンドは `~80kB` gzipped です。
  - arm64 / Raspberry Pi をサポートします。

## インストール

- [Docker](https://join-lemmy.org/docs/en/administration/install_docker.html)
- [Ansible](https://join-lemmy.org/docs/en/administration/install_ansible.html)

## Lemmy プロジェクト

### アプリ

- [lemmy-ui - Lemmy の公式ウェブアプリ](https://github.com/LemmyNet/lemmy-ui)
- [lemmyBB -phpBB をベースにした Lemmy フォーラム UI](https://github.com/LemmyNet/lemmyBB)
- [Jerboa - Lemmy の開発者が作った Android ネイティブアプリ](https://github.com/dessalines/jerboa)
- [Mlem - iOS 用 Lemmy クライアント](https://github.com/buresdv/Mlem)

### ライブラリ

- [lemmy-js-client](https://github.com/LemmyNet/lemmy-js-client)
- [lemmy-rust-client](https://github.com/LemmyNet/lemmy/tree/main/crates/api_common)
- [go-lemmy](https://gitea.arsenm.dev/Arsen6331/go-lemmy)
- [Dart API client](https://github.com/LemmurOrg/lemmy_api_client)
- [Lemmy-Swift-Client](https://github.com/rrainn/Lemmy-Swift-Client)
- [Reddit -> Lemmy Importer](https://github.com/rileynull/RedditLemmyImporter)
- [lemmy-bot - Lemmy のボットを簡単に作るための Typescript ライブラリ](https://github.com/SleeplessOne1917/lemmy-bot)
- [Lemmy の Reddit API ラッパー](https://github.com/derivator/tafkars)
- [Pythörhead - Lemmy API と統合するための Python パッケージ](https://pypi.org/project/pythorhead/)

## サポート / 寄付

Lemmy はフリーでオープンソースのソフトウェアです。つまり、広告やマネタイズ、ベンチャーキャピタルは一切ありません。あなたの寄付は、直接プロジェクトのフルタイム開発をサポートします。

- [Liberapay でのサポート](https://liberapay.com/Lemmy)。
- [Ko-fi でのサポート](https://ko-fi.com/lemmynet).
- [Patreon でのサポート](https://www.patreon.com/dessalines)。
- [OpenCollective でのサポート](https://opencollective.com/lemmy)。
- [スポンサーのリスト](https://join-lemmy.org/donate)。

### 暗号通貨

- bitcoin: `1Hefs7miXS5ff5Ck5xvmjKjXf5242KzRtK`
- ethereum: `0x400c96c96acbC6E7B3B43B1dc1BB446540a88A01`
- monero: `41taVyY6e1xApqKyMVDRVxJ76sPkfZhALLTjRvVKpaAh2pBd4wv9RgYj1tSPrx8wc6iE1uWUfjtQdTmTy2FGMeChGVKPQuV`

## コントリビュート

- [コントリビュート手順](https://join-lemmy.org/docs/en/contributors/01-overview.html)
- [Docker 開発](https://join-lemmy.org/docs/en/contributors/03-docker-development.html)
- [Local 開発](https://join-lemmy.org/docs/en/contributors/02-local-development.html)

### 翻訳について

- 翻訳を手伝いたい方は、[Weblate](https://weblate.join-lemmy.org/projects/lemmy/) を見てみてください。また、[ドキュメントを翻訳する](https://github.com/LemmyNet/lemmy-docs#adding-a-new-language)ことでも支援できます。

## お問い合わせ

- [Mastodon](https://mastodon.social/@LemmyDev)
- [Lemmy サポートフォーラム](https://lemmy.ml/c/lemmy_support)

## コードのミラー

- [GitHub](https://github.com/LemmyNet/lemmy)
- [Gitea](https://git.join-lemmy.org/LemmyNet/lemmy)
- [Codeberg](https://codeberg.org/LemmyNet/lemmy)

## クレジット

ロゴは Andy Cuccaro (@andycuccaro) が CC-BY-SA 4.0 ライセンスで作成しました。

---

## File: readmes/README.ru.md

## О проекте

| Десктоп                                                                                                         | Мобильный                                                                                                   |
| --------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
|  |  |

[Lemmy](https://github.com/LemmyNet/lemmy) это аналог таких сайтов как [Reddit](https://reddit.com), [Lobste.rs](https://lobste.rs), или [Hacker News](https://news.ycombinator.com/): вы подписываетесь на форумы, которые вас интересуют , размещаете ссылки и дискутируете, затем голосуете и комментируете их. Однако за кулисами всё совсем по-другому; любой может легко запустить сервер, и все эти серверы объединены (например электронная почта) и подключены к одной вселенной, именуемой [Федиверс](https://ru.wikipedia.org/wiki/Fediverse).

Для агрегатора ссылок это означает, что пользователь, зарегистрированный на одном сервере, может подписаться на форумы на любом другом сервере и может вести обсуждения с пользователями, зарегистрированными в другом месте.

Основная цель - создать легко размещаемую, децентрализованную альтернативу Reddit и другим агрегаторам ссылок, вне их корпоративного контроля и вмешательства.

Каждый сервер Lemmy может устанавливать свою собственную политику модерации; назначать администраторов всего сайта и модераторов сообщества для защиты от троллей и создания здоровой, нетоксичной среды, в которой каждый может чувствовать себя комфортно.

_Примечание: API-интерфейсы WebSocket и HTTP в настоящее время нестабильны_

### Почему назвали Lemmy (рус.Лемми)?

- Ведущий певец из [Motörhead](https://invidio.us/watch?v=pWB5JZRGl0U).
- Старая школа [video game](<https://en.wikipedia.org/wiki/Lemmings_(video_game)>).
- Это [Koopa from Super Mario](https://www.mariowiki.com/Lemmy_Koopa).
- Это [furry rodents](http://sunchild.fpwc.org/lemming-the-little-giant-of-the-north/).

### Содержит

- [Rust](https://www.rust-lang.org)
- [Actix](https://actix.rs/)
- [Diesel](http://diesel.rs/)
- [Inferno](https://infernojs.org)
- [Typescript](https://www.typescriptlang.org/)

## Возможности

- Открытое программное обеспечение, [Лицензия AGPL](/LICENSE).
- Возможность самостоятельного размещения, простота развёртывания.
  - Работает на [Docker](https://join-lemmy.org/docs/en/administration/install_docker.html) и [Ansible](https://join-lemmy.org/docs/en/administration/install_ansible.html).
- Понятый и удобный интерфейс для мобильных устройств.
  - Для регистрации требуется минимум: имя пользователя и пароль!
  - Поддержка аватара пользователя.
  - Обновление цепочек комментариев в реальном времени.
  - Полный подсчёт голосов `(+/-)` как в старом reddit.
  - Темы, включая светлые, темные и солнечные.
  - Эмодзи с поддержкой автозаполнения. Напечатайте `:`
  - Упоминание пользователя тегом `@`, Упоминание сообщества тегом `!`.
  - Интегрированная загрузка изображений как в сообщениях, так и в комментариях.
  - Сообщение может состоять из заголовка и любой комбинации собственного текста, URL-адреса или чего-либо еще.
  - Уведомления, ответы на комментарии и когда вас отметили.
    - Уведомления могут быть отправлены на электронную почту.
    - Поддержка личных сообщений.
  - i18n / поддержка интернационализации.
  - RSS / Atom ленты для `Все`, `Подписок`, `Входящих`, `Пользователь`, and `Сообщества`.
- Поддержка кросс-постинга.
  - _Поиск похожих постов_ при создании новых. Отлично подходит для вопросов / ответов сообществ.
- Возможности модерации.
  - Журналы (Логи) Публичной Модерации.
  - Можно прикреплять посты в топ сообщества.
  - Оба и администраторы сайта и модераторы сообщества, могут назначать других модераторов.
  - Можно блокировать, удалять и восстанавливать сообщения и комментарии.
  - Можно банить и разблокировать пользователей в сообществе и на сайте.
  - Можно передавать сайт и сообщества другим.
- Можно полностью стереть ваши данные, удалив все посты и комментарии.
- NSFW (аббр. Небезопасный/неподходящий для работы) пост / поддерживается сообществом.
- Поддержка OEmbed через Iframely.
- Высокая производительность.
  - Сервер написан на rust.
  - Фронтэнд (клиентская сторона пользовательского интерфейса) всего `~80kB` архив gzipp.
  - Поддерживается архитектура arm64 / устройства Raspberry Pi.

## Установка

- [Docker](https://join-lemmy.org/docs/en/administration/install_docker.html)
- [Ansible](https://join-lemmy.org/docs/en/administration/install_ansible.html)

## Проекты Lemmy

### Приложения

- [lemmy-ui - Официальное веб приложение для lemmy](https://github.com/LemmyNet/lemmy-ui)
- [Lemmur - Мобильные клиенты Lemmy для (Android, Linux, Windows)](https://github.com/LemmurOrg/lemmur)
- [Remmel - Оригинальное приложение для iOS](https://github.com/uuttff8/Lemmy-iOS)

### Библиотеки

- [lemmy-js-client](https://github.com/LemmyNet/lemmy-js-client)
- [Kotlin API ( в разработке )](https://github.com/eiknat/lemmy-client)
- [Dart API client ( в разработке )](https://github.com/LemmurOrg/lemmy_api_client)

## Поддержать / Пожертвовать

Lemmy - бесплатное программное обеспечение с открытым исходным кодом, что означает отсутствие рекламы, монетизации и даже венчурного капитала. Ваши пожертвования, напрямую поддерживают постоянное развитие проекта.

- [Поддержать на Liberapay](https://liberapay.com/Lemmy).
- [Поддержать на Ko-fi](https://ko-fi.com/lemmynet).
- [Поддержать на Patreon](https://www.patreon.com/dessalines).
- [Поддержать на OpenCollective](https://opencollective.com/lemmy).
- [Список Спонсоров](https://join-lemmy.org/sponsors).

### Криптовалюты

- bitcoin (Биткоин): `1Hefs7miXS5ff5Ck5xvmjKjXf5242KzRtK`
- ethereum (Эфириум): `0x400c96c96acbC6E7B3B43B1dc1BB446540a88A01`
- monero (Монеро): `41taVyY6e1xApqKyMVDRVxJ76sPkfZhALLTjRvVKpaAh2pBd4wv9RgYj1tSPrx8wc6iE1uWUfjtQdTmTy2FGMeChGVKPQuV`

## Вклад

- [Инструкции по внесению вклада](https://join-lemmy.org/docs/en/contributing/contributing.html)
- [Docker разработка](https://join-lemmy.org/docs/en/contributing/docker_development.html)
- [Локальное развитие](https://join-lemmy.org/docs/en/contributing/local_development.html)

### Переводы

Если вы хотите помочь с переводом, взгляните на [Weblate](https://weblate.yerbamate.ml/projects/lemmy/joinlemmy/ru/). Вы также можете помочь нам [перевести документацию](https://github.com/LemmyNet/lemmy-docs#adding-a-new-language).

## Контакт

- [Mastodon](https://mastodon.social/@LemmyDev)
- [Matrix](https://matrix.to/#/#lemmy:matrix.org)

## Зеркала с кодом

- [GitHub](https://github.com/LemmyNet/lemmy)
- [Gitea](https://yerbamate.ml/LemmyNet/lemmy)
- [Codeberg](https://codeberg.org/LemmyNet/lemmy)

## Благодарность

Логотип сделан Andy Cuccaro (@andycuccaro) под лицензией CC-BY-SA 4.0.

---

## File: readmes/README.zh.hans.md

## 关于项目

| 桌面应用                                                                                                        | 移动应用                                                                                                    |
| --------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
|  |  |

[Lemmy](https://github.com/LemmyNet/lemmy) 与 [Reddit](https://reddit.com)、[Lobste.rs](https://lobste.rs) 或 [Hacker News](https://news.ycombinator.com/) 等网站类似：你可以订阅你感兴趣的论坛，发布链接和讨论，然后进行投票或评论。但在幕后，Lemmy 和他们不同——任何人都可以很容易地运行一个服务器，所有服务器都是联邦式的（想想电子邮件），并连接到 [联邦宇宙](https://zh.wikipedia.org/wiki/%E8%81%94%E9%82%A6%E5%AE%87%E5%AE%99)。

对于一个链接聚合器来说，这意味着在一个服务器上注册的用户可以订阅任何其他服务器上的论坛，并可以与其他地方注册的用户进行讨论。

它是 Reddit 和其他链接聚合器的一个易于自托管的、分布式的替代方案，不受公司的控制和干涉。

每个 Lemmy 服务器都可以设置自己的管理政策；任命全站管理员和社区版主来阻止引战和钓鱼的用户，并培养一个健康、无毒的环境，让所有人都能放心地作出贡献。

### 为什么叫 Lemmy？

- 来自 [Motörhead](https://invidio.us/watch?v=pWB5JZRGl0U) 的主唱。
- 老式的 [电子游戏](<https://en.wikipedia.org/wiki/Lemmings_(video_game)>)。
- [超级马里奥中的库巴](https://www.mariowiki.com/Lemmy_Koopa)。
- [毛茸茸的啮齿动物](http://sunchild.fpwc.org/lemming-the-little-giant-of-the-north/)。

### 采用以下项目构建

- [Rust](https://www.rust-lang.org)
- [Actix](https://actix.rs/)
- [Diesel](http://diesel.rs/)
- [Inferno](https://infernojs.org)
- [Typescript](https://www.typescriptlang.org/)

## 特性

- 开源，采用 [AGPL 协议](/LICENSE)。
- 可自托管，易于部署。
  - 附带 [Docker](https://join-lemmy.org/docs/en/administration/install_docker.html) 或 [Ansible](https://join-lemmy.org/docs/en/administration/install_ansible.html)。
- 干净、移动设备友好的界面。
  - 仅需用户名和密码就可以注册!
  - 支持用户头像。
  - 实时更新的评论串。
  - 类似旧版 Reddit 的评分功能 `(+/-)`。
  - 主题，有深色 / 浅色主题和 Solarized 主题。
  - Emoji 和自动补全。输入 `:` 开始。
  - 通过 `@` 提及用户，`!` 提及社区。
  - 在帖子和评论中都集成了图片上传功能。
  - 一个帖子可以由一个标题和自我文本的任何组合组成，一个 URL，或没有其他。
  - 评论回复和提及时的通知。
    - 通知可通过电子邮件发送。
    - 支持私信。
  - i18n（国际化）支持。
  - `All`、`Subscribed`、`Inbox`、`User` 和 `Community` 的 RSS / Atom 订阅。
- 支持多重发布。
  - 在创建新的帖子时，有 _相似帖子_ 的建议，对问答式社区很有帮助。
- 监管能力。
  - 公开的修改日志。
  - 可以把帖子在社区置顶。
  - 既有网站管理员，也有可以任命其他版主社区版主。
  - 可以锁定、删除和恢复帖子和评论。
  - 可以禁止和解禁社区和网站的用户。
  - 可以将网站和社区转让给其他人。
- 可以完全删除你的数据，替换所有的帖子和评论。
- NSFW 帖子 / 社区支持。
- 高性能。
  - 服务器采用 Rust 编写。
  - 前端 gzip 后约 `~80kB`。
  - 支持 arm64 架构和树莓派。

## 安装

- [Docker](https://join-lemmy.org/docs/en/administration/install_docker.html)
- [Ansible](https://join-lemmy.org/docs/en/administration/install_ansible.html)

## Lemmy 项目

### 应用

- [lemmy-ui - Lemmy 的官方网页应用](https://github.com/LemmyNet/lemmy-ui)
- [Lemmur - 一个 Lemmy 的移动客户端（支持安卓、Linux、Windows）](https://github.com/LemmurOrg/lemmur)
- [Jerboa - 一个由 Lemmy 的开发者打造的原生 Android 应用](https://github.com/dessalines/jerboa)
- [Remmel - 一个原生 iOS 应用](https://github.com/uuttff8/Lemmy-iOS)

### 库

- [lemmy-js-client](https://github.com/LemmyNet/lemmy-js-client)
- [Kotlin API (尚在开发)](https://github.com/eiknat/lemmy-client)
- [Dart API client](https://github.com/LemmurOrg/lemmy_api_client)

## 支持和捐助

Lemmy 是免费的开源软件，无广告，无营利，无风险投资。您的捐款直接支持我们全职开发这一项目。

- [在 Liberapay 上支持](https://liberapay.com/Lemmy)。
- [在 Ko-fi 上支持](https://ko-fi.com/lemmynet).
- [在 Patreon 上支持](https://www.patreon.com/dessalines)。
- [在 OpenCollective 上支持](https://opencollective.com/lemmy)。
- [赞助者列表](https://join-lemmy.org/sponsors)。

### 加密货币

- 比特币：`1Hefs7miXS5ff5Ck5xvmjKjXf5242KzRtK`
- 以太坊: `0x400c96c96acbC6E7B3B43B1dc1BB446540a88A01`
- 门罗币：`41taVyY6e1xApqKyMVDRVxJ76sPkfZhALLTjRvVKpaAh2pBd4wv9RgYj1tSPrx8wc6iE1uWUfjtQdTmTy2FGMeChGVKPQuV`
- 艾达币：`addr1q858t89l2ym6xmrugjs0af9cslfwvnvsh2xxp6x4dcez7pf5tushkp4wl7zxfhm2djp6gq60dk4cmc7seaza5p3slx0sakjutm`

## 贡献

- [贡献指南](https://join-lemmy.org/docs/en/contributing/contributing.html)
- [Docker 开发](https://join-lemmy.org/docs/en/contributing/docker_development.html)
- [本地开发](https://join-lemmy.org/docs/en/contributing/local_development.html)

### 翻译

如果你想帮助翻译，请至 [Weblate](https://weblate.yerbamate.ml/projects/lemmy/)；也可以 [翻译文档](https://github.com/LemmyNet/lemmy-docs#adding-a-new-language)。

## 联系

- [Mastodon](https://mastodon.social/@LemmyDev)
- [Lemmy 支持论坛](https://lemmy.ml/c/lemmy_support)

## 代码镜像

- [GitHub](https://github.com/LemmyNet/lemmy)
- [Gitea](https://yerbamate.ml/LemmyNet/lemmy)
- [Codeberg](https://codeberg.org/LemmyNet/lemmy)

## 致谢

Logo 由 Andy Cuccaro (@andycuccaro) 制作，采用 CC-BY-SA 4.0 协议释出。

---

## File: readmes/README.zh.hant.md

## 關於專案

| 桌面設備                                                                                                        | 行動裝置                                                                                                    |
| --------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
|  |  |

[Lemmy](https://github.com/LemmyNet/lemmy) 與 [Reddit](https://reddit.com)、[Lobste.rs](https://lobste.rs) 或 [Hacker News](https://news.ycombinator.com/) 等網站類似：你可以訂閱你感興趣的論壇，釋出連結和討論，然後進行投票或評論。但在幕後，Lemmy 和他們不同——任何人都可以很容易地架設一個伺服器，所有伺服器都是聯邦式的（想想電子郵件），並與 [聯邦宇宙](https://zh.wikipedia.org/wiki/%E8%81%94%E9%82%A6%E5%AE%87%E5%AE%99) 互聯。

對於一個連結聚合器來說，這意味著在一個伺服器上註冊的使用者可以訂閱任何其他伺服器上的論壇，並可以與其他地方註冊的使用者進行討論。

它是 Reddit 和其他連結聚合器的一個易於自託管的、分散式的替代方案，不受公司的控制和干涉。

每個 Lemmy 伺服器都可以設定自己的管理政策；任命全站管理員和社群版主來阻止網路白目，並培養一個健康、無毒的環境，讓所有人都能放心地作出貢獻。

### 為什麼叫 Lemmy？

- 來自 [Motörhead](https://invidio.us/watch?v=pWB5JZRGl0U) 的主唱。
- 老式的 [電子遊戲](<https://en.wikipedia.org/wiki/Lemmings_(video_game)>)。
- [超級馬里奧中的庫巴](https://www.mariowiki.com/Lemmy_Koopa)。
- [毛茸茸的齧齒動物](http://sunchild.fpwc.org/lemming-the-little-giant-of-the-north/)。

### 採用以下專案構建

- [Rust](https://www.rust-lang.org)
- [Actix](https://actix.rs/)
- [Diesel](http://diesel.rs/)
- [Inferno](https://infernojs.org)
- [Typescript](https://www.typescriptlang.org/)

## 特性

- 開源，採用 [AGPL 協議](/LICENSE)。
- 可自託管，易於部署。
  - 附帶 [Docker](https://join-lemmy.org/docs/en/administration/install_docker.html) 或 [Ansible](https://join-lemmy.org/docs/en/administration/install_ansible.html)。
- 乾淨、移動裝置友好的介面。
  - 僅需使用者名稱和密碼就可以註冊!
  - 支援使用者頭像。
  - 實時更新的評論串。
  - 類似舊版 Reddit 的評分功能 `(+/-)`。
  - 主題，有深色 / 淺色主題和 Solarized 主題。
  - Emoji 和自動補全。輸入 `:` 開始。
  - 透過 `@` 提及使用者，`!` 提及社群。
  - 在帖子和評論中都集成了圖片上傳功能。
  - 一個帖子可以由一個標題和自我文字的任何組合組成，一個 URL，或沒有其他。
  - 評論回覆和提及時的通知。
    - 通知可透過電子郵件傳送。
    - 支援私信。
  - i18n（國際化）支援。
  - `All`、`Subscribed`、`Inbox`、`User` 和 `Community` 的 RSS / Atom 訂閱。
- 支援多重發布。
  - 在建立新的帖子時，有 _相似帖子_ 的建議，對問答式社群很有幫助。
- 監管能力。
  - 公開的修改日誌。
  - 可以把帖子在社群置頂。
  - 既有網站管理員，也有可以任命其他版主社群版主。
  - 可以鎖定、刪除和恢復帖子和評論。
  - 可以封鎖和解除封鎖社群和網站的使用者。
  - 可以將網站和社群轉讓給其他人。
- 可以完全刪除你的資料，替換所有的帖子和評論。
- NSFW 帖子 / 社群支援。
- 高效能。
  - 伺服器採用 Rust 編寫。
  - 前端 gzip 後約 `~80kB`。
  - 支援 arm64 架構和樹莓派。

## 安裝

- [Docker](https://join-lemmy.org/docs/en/administration/install_docker.html)
- [Ansible](https://join-lemmy.org/docs/en/administration/install_ansible.html)

## Lemmy 專案

### 應用

- [lemmy-ui - Lemmy 的官方網頁應用](https://github.com/LemmyNet/lemmy-ui)
- [Lemmur - 一個 Lemmy 的行動應用程式（支援安卓、Linux、Windows）](https://github.com/LemmurOrg/lemmur)
- [Jerboa - 一個由 Lemmy 的開發者打造的原生 Android 應用程式](https://github.com/dessalines/jerboa)
- [Remmel - 一個原生 iOS 應用程式](https://github.com/uuttff8/Lemmy-iOS)

### 庫

- [lemmy-js-client](https://github.com/LemmyNet/lemmy-js-client)
- [Kotlin API (尚在開發)](https://github.com/eiknat/lemmy-client)
- [Dart API client](https://github.com/LemmurOrg/lemmy_api_client)

## 支援和捐助

Lemmy 是免費的開放原始碼軟體，無廣告，無營利，無風險投資。您的捐款直接支援我們全職開發這一專案。

- [在 Liberapay 上支援](https://liberapay.com/Lemmy)。
- [在 Ko-fi 上支援](https://ko-fi.com/lemmynet).
- [在 Patreon 上支援](https://www.patreon.com/dessalines)。
- [在 OpenCollective 上支援](https://opencollective.com/lemmy)。
- [贊助者列表](https://join-lemmy.org/sponsors)。

### 加密貨幣

- 比特幣：`1Hefs7miXS5ff5Ck5xvmjKjXf5242KzRtK`
- 以太坊：`0x400c96c96acbC6E7B3B43B1dc1BB446540a88A01`
- 門羅幣：`41taVyY6e1xApqKyMVDRVxJ76sPkfZhALLTjRvVKpaAh2pBd4wv9RgYj1tSPrx8wc6iE1uWUfjtQdTmTy2FGMeChGVKPQuV`
- 艾達幣：`addr1q858t89l2ym6xmrugjs0af9cslfwvnvsh2xxp6x4dcez7pf5tushkp4wl7zxfhm2djp6gq60dk4cmc7seaza5p3slx0sakjutm`

## 貢獻

- [貢獻指南](https://join-lemmy.org/docs/en/contributing/contributing.html)
- [Docker 開發](https://join-lemmy.org/docs/en/contributing/docker_development.html)
- [本地開發](https://join-lemmy.org/docs/en/contributing/local_development.html)

### 翻譯

如果你想幫助翻譯，請至 [Weblate](https://weblate.yerbamate.ml/projects/lemmy/)；也可以 [翻譯文檔](https://github.com/LemmyNet/lemmy-docs#adding-a-new-language)。

## 聯絡

- [Mastodon](https://mastodon.social/@LemmyDev)
- [Lemmy 支援論壇](https://lemmy.ml/c/lemmy_support)

## 程式碼鏡像

- [GitHub](https://github.com/LemmyNet/lemmy)
- [Gitea](https://yerbamate.ml/LemmyNet/lemmy)
- [Codeberg](https://codeberg.org/LemmyNet/lemmy)

## 致謝

Logo 由 Andy Cuccaro (@andycuccaro) 製作，採用 CC-BY-SA 4.0 協議釋出。