muhammedOdeh3600/Maqtaa
1
0
نسخ 0
نسخ من khaledmahfouz5/Maqtaa
الشفرة طلبات السحب النشاط

Merge pull request #15 from KhaledMahfouz5/main

تصفح المصدر 
Translate README to Arabic and add README-en.md .
هذا الالتزام موجود في:
Muhammed Odeh
2026-04-25 21:33:11 +00:00
ملتزم من قبل GitHub
الأصل 4841cf21e5 b926031ceb
التزام 43f733bf90
2 ملفات معدلة مع 157 إضافات و43 حذوفات
تنزيل ملف التصحيح تنزيل ملف الاختلاف توسيع جميع الملفات طي جميع الملفات

114
README-en.md Normal file
عرض الملف

@@ -0,0 +1,114 @@
# Opengist
<img height="108px" src="https://raw.githubusercontent.com/thomiceli/opengist/master/public/img/opengist.svg" alt="Opengist" align="right" />
Opengist is a **self-hosted** Pastebin **powered by Git**. All snippets are stored in a Git repository and can be
read and/or modified using standard Git commands, or with the web interface.
It is similar to [GitHub Gist](https://gist.github.com/), but open-source and could be self-hosted.
[Home Page](https://opengist.io) • [Documentation](https://opengist.io/docs) • [Discord](https://discord.gg/9Pm3X5scZT) • [Demo](https://demo.opengist.io)
![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/thomiceli/opengist?sort=semver)
![License](https://img.shields.io/github/license/thomiceli/opengist?color=blue)
[![Go CI](https://github.com/thomiceli/opengist/actions/workflows/go.yml/badge.svg)](https://github.com/thomiceli/opengist/actions/workflows/go.yml)
[![Go Report Card](https://goreportcard.com/badge/github.com/thomiceli/opengist)](https://goreportcard.com/report/github.com/thomiceli/opengist)
[![Translate](https://tr.opengist.io/widget/_/svg-badge.svg)](https://tr.opengist.io/projects/_/opengist/)
## Features
* Create public, unlisted or private snippets
* [Init](/docs/usage/init-via-git.md) / Clone / Pull / Push snippets **via Git** over HTTP or SSH
* Syntax highlighting ; markdown & CSV support
* Search code in snippets; browse users snippets, likes and forks
* Add topics to snippets
* Embed snippets in other websites
* Revisions history
* Like / Fork snippets
* Download raw files or as a ZIP archive
* OAuth2 login with GitHub, GitLab, Gitea, and OpenID Connect
* Restrict or unrestrict snippets visibility to anonymous users
* Docker support / Helm Chart
* [More...](/docs/introduction.md#features)
## Quick start
### With Docker
Docker [images](https://github.com/thomiceli/opengist/pkgs/container/opengist) are available for each release :
```shell
docker pull ghcr.io/thomiceli/opengist:1.12
```
It can be used in a `docker-compose.yml` file :
1. Create a `docker-compose.yml` file with the following content
2. Run `docker compose up -d`
3. Opengist is now running on port 6157, you can browse http://localhost:6157
```yml
services:
opengist:
image: ghcr.io/thomiceli/opengist:1.12
container_name: opengist
restart: unless-stopped
ports:
- "6157:6157" # HTTP port
- "2222:2222" # SSH port, can be removed if you don't use SSH
volumes:
- "$HOME/.opengist:/opengist"
```
You can define which user/group should run the container and own the files by setting the `UID` and `GID` environment variables :
```yml
services:
opengist:
# ...
environment:
UID: 1001
GID: 1001
```
### Via binary
Download the archive for your system from the release page [here](https://github.com/thomiceli/opengist/releases/latest), and extract it.
```shell
# example for linux amd64
wget https://github.com/thomiceli/opengist/releases/download/v1.12.1/opengist1.12.1-linux-amd64.tar.gz
tar xzvf opengist1.12.1-linux-amd64.tar.gz
cd opengist
chmod +x opengist
./opengist # with or without `--config config.yml`
```
Opengist is now running on port 6157, you can browse http://localhost:6157
### From source
Requirements: [Git](https://git-scm.com/downloads) (2.28+), [Go](https://go.dev/doc/install) (1.23+), [Node.js](https://nodejs.org/en/download/) (16+), [Make](https://linux.die.net/man/1/make) (optional, but easier)
```shell
git clone https://github.com/thomiceli/opengist
cd opengist
make
./opengist
```
Opengist is now running on port 6157, you can browse http://localhost:6157
---
To create and run a development environment, see [run-development.md](/docs/contributing/development.md).
## Documentation
The documentation is available at [https://opengist.io/](https://opengist.io/) or in the [/docs](/docs) directory.
## License
Opengist is licensed under the [AGPL-3.0 license](/LICENSE).

86
README.md
عرض الملف

@@ -1,12 +1,12 @@
# Opengist # مقطع
<img height="108px" src="https://raw.githubusercontent.com/thomiceli/opengist/master/public/img/opengist.svg" alt="Opengist" align="right" /> <img height="108px" src="https://raw.githubusercontent.com/thomiceli/opengist/master/public/img/opengist.svg" alt="مقطع" align="right" />
Opengist is a **self-hosted** Pastebin **powered by Git**. All snippets are stored in a Git repository and can be مقطع هو مكان لوضع مقاطع صغيرة من الكود البرمجي **مستضاف ذاتيًا** و**مدعوم بـ Git**. يتم تخزين جميع المقاطع في مستودع Git ويمكن
read and/or modified using standard Git commands, or with the web interface. قراءتها و/أو تعديلها باستخدام أوامر Git القياسية أو عبر واجهة الويب.
It is similar to [GitHub Gist](https://gist.github.com/), but open-source and could be self-hosted. وهو مشابه لـ [GitHub Gist](https://gist.github.com/)، لكنه مفتوح المصدر ويمكن استضافته ذاتيًا.
[Home Page](https://opengist.io) • [Documentation](https://opengist.io/docs) • [Discord](https://discord.gg/9Pm3X5scZT) • [Demo](https://demo.opengist.io) [الصفحة الرئيسية](https://opengist.io) • [التوثيق](https://opengist.io/docs) • [ديسكورد](https://discord.gg/9Pm3X5scZT) • [نسخة تجريبية](https://demo.opengist.io)
![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/thomiceli/opengist?sort=semver) ![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/thomiceli/opengist?sort=semver)
@@ -15,37 +15,37 @@ It is similar to [GitHub Gist](https://gist.github.com/), but open-source and co
[![Go Report Card](https://goreportcard.com/badge/github.com/thomiceli/opengist)](https://goreportcard.com/report/github.com/thomiceli/opengist) [![Go Report Card](https://goreportcard.com/badge/github.com/thomiceli/opengist)](https://goreportcard.com/report/github.com/thomiceli/opengist)
[![Translate](https://tr.opengist.io/widget/_/svg-badge.svg)](https://tr.opengist.io/projects/_/opengist/) [![Translate](https://tr.opengist.io/widget/_/svg-badge.svg)](https://tr.opengist.io/projects/_/opengist/)
## Features ## الميزات
* Create public, unlisted or private snippets * إنشاء مقاطع عامة أو غير مدرجة أو خاصة
* [Init](/docs/usage/init-via-git.md) / Clone / Pull / Push snippets **via Git** over HTTP or SSH * [Init](/docs/usage/init-via-git.md) / Clone / Pull / Push للمقاطع **عبر Git** باستخدام HTTP أو SSH
* Syntax highlighting ; markdown & CSV support * تلوين الصياغة؛ دعم Markdown وCSV
* Search code in snippets; browse users snippets, likes and forks * البحث في كود المقاطع؛ وتصفح مقاطع المستخدمين والإعجابات والتفريعات
* Add topics to snippets * إضافة مواضيع للمقاطع
* Embed snippets in other websites * تضمين المقاطع في مواقع أخرى
* Revisions history * سجل المراجعات
* Like / Fork snippets * الإعجاب بالمقاطع / تفريعها
* Download raw files or as a ZIP archive * تنزيل الملفات الخام أو كأرشيف ZIP
* OAuth2 login with GitHub, GitLab, Gitea, and OpenID Connect * تسجيل الدخول عبر OAuth2 مع GitHub وGitLab وGitea وOpenID Connect
* Restrict or unrestrict snippets visibility to anonymous users * تقييد أو إلغاء تقييد ظهور المقاطع للمستخدمين المجهولين
* Docker support / Helm Chart * دعم Docker / Helm Chart
* [More...](/docs/introduction.md#features) * [المزيد...](/docs/introduction.md#features)
## Quick start ## البدء السريع
### With Docker ### باستخدام Docker
Docker [images](https://github.com/thomiceli/opengist/pkgs/container/opengist) are available for each release : صور Docker [images](https://github.com/thomiceli/opengist/pkgs/container/opengist) متاحة لكل إصدار:
```shell ```shell
docker pull ghcr.io/thomiceli/opengist:1.12 docker pull ghcr.io/thomiceli/opengist:1.12
``` ```
It can be used in a `docker-compose.yml` file : يمكن استخدامه عبر ملف `docker-compose.yml`:
1. Create a `docker-compose.yml` file with the following content 1. أنشئ ملف `docker-compose.yml` بالمحتوى التالي
2. Run `docker compose up -d` 2. شغّل `docker compose up -d`
3. Opengist is now running on port 6157, you can browse http://localhost:6157 3. أصبح مقطع يعمل الآن على المنفذ 6157، ويمكنك التصفح عبر http://localhost:6157
```yml ```yml
services: services:
@@ -54,13 +54,13 @@ services:
container_name: opengist container_name: opengist
restart: unless-stopped restart: unless-stopped
ports: ports:
- "6157:6157" # HTTP port - "6157:6157" # منفذ HTTP
- "2222:2222" # SSH port, can be removed if you don't use SSH - "2222:2222" # منفذ SSH، ويمكن حذفه إذا لم تستخدم SSH
volumes: volumes:
- "$HOME/.opengist:/opengist" - "$HOME/.opengist:/opengist"
``` ```
You can define which user/group should run the container and own the files by setting the `UID` and `GID` environment variables : يمكنك تحديد المستخدم/المجموعة التي يجب أن تشغّل الحاوية وتمتلك الملفات عبر ضبط متغيري البيئة `UID` و`GID`:
```yml ```yml
services: services:
@@ -71,25 +71,25 @@ services:
GID: 1001 GID: 1001
``` ```
### Via binary ### عبر الملف التنفيذي
Download the archive for your system from the release page [here](https://github.com/thomiceli/opengist/releases/latest), and extract it. نزّل الأرشيف المناسب لنظامك من صفحة الإصدارات من [هنا](https://github.com/thomiceli/opengist/releases/latest)، ثم فك الضغط.
```shell ```shell
# example for linux amd64 # مثال لنظام linux amd64
wget https://github.com/thomiceli/opengist/releases/download/v1.12.1/opengist1.12.1-linux-amd64.tar.gz wget https://github.com/thomiceli/opengist/releases/download/v1.12.1/opengist1.12.1-linux-amd64.tar.gz
tar xzvf opengist1.12.1-linux-amd64.tar.gz tar xzvf opengist1.12.1-linux-amd64.tar.gz
cd opengist cd opengist
chmod +x opengist chmod +x opengist
./opengist # with or without `--config config.yml` ./opengist # مع أو بدون `--config config.yml`
``` ```
Opengist is now running on port 6157, you can browse http://localhost:6157 أصبح مقطع يعمل الآن على المنفذ 6157، ويمكنك التصفح عبر http://localhost:6157
### From source ### من المصدر
Requirements: [Git](https://git-scm.com/downloads) (2.28+), [Go](https://go.dev/doc/install) (1.23+), [Node.js](https://nodejs.org/en/download/) (16+), [Make](https://linux.die.net/man/1/make) (optional, but easier) المتطلبات: [Git](https://git-scm.com/downloads) (2.28+)، [Go](https://go.dev/doc/install) (1.23+)، [Node.js](https://nodejs.org/en/download/) (16+)، [Make](https://linux.die.net/man/1/make) (اختياري لكنه أسهل)
```shell ```shell
git clone https://github.com/thomiceli/opengist git clone https://github.com/thomiceli/opengist
@@ -98,17 +98,17 @@ make
./opengist ./opengist
``` ```
Opengist is now running on port 6157, you can browse http://localhost:6157 أصبح مقطع يعمل الآن على المنفذ 6157، ويمكنك التصفح عبر http://localhost:6157
--- ---
To create and run a development environment, see [run-development.md](/docs/contributing/development.md). لإنشاء وتشغيل بيئة تطوير، راجع [run-development.md](/docs/contributing/development.md).
## Documentation ## التوثيق
The documentation is available at [https://opengist.io/](https://opengist.io/) or in the [/docs](/docs) directory. التوثيق متاح على [https://opengist.io/](https://opengist.io/) أو داخل مجلد [/docs](/docs).
## License ## الرخصة
Opengist is licensed under the [AGPL-3.0 license](/LICENSE). مقطع مرخّص تحت [AGPL-3.0 license](/LICENSE).