Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
69 changes: 69 additions & 0 deletions README.ar.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
> ترجمة مجتمعية (مسوّدة) — سياسة NTARI رقم P2-002، البثّ العالمي المتعدد اللغات. المصدر: README.md (الأصل الإنجليزي، لقطة بتاريخ 2026-10-05). مسوّدة مجتمعية بمساعدة آلية، في انتظار مراجعة مشرف الصيانة الإقليمي وفق P2-002 §3.1. تبقى المواصفات التقنية الأساسية بالإنجليزية وفق §2.2.
>
> تصحيحات الترجمة مساهمات نرحّب بها ونقدّرها كسائر المساهمات، فإذا لاحظت خطأً
> في هذه الترجمة فيمكنك إصلاحه بنفسك عبر إنشاء fork للمستودع وفتح pull
> request: https://github.com/NTARI-RAND/agrinet-docs

# الموقع الإلكتروني

بُني هذا الموقع باستخدام [Docusaurus](https://docusaurus.io/)، وهو مولّد حديث للمواقع الثابتة.

## التثبيت

```bash
yarn
```

## التطوير المحلي

```bash
yarn start
```

يشغّل هذا الأمر خادم تطوير محليًا ويفتح نافذة متصفح. وتظهر معظم التغييرات مباشرةً دون الحاجة إلى إعادة تشغيل الخادم.

## البناء

```bash
yarn build
```

يولّد هذا الأمر محتوى ثابتًا في المجلد `build`، ويمكن تقديمه باستخدام أي خدمة لاستضافة المحتوى الثابت.

## النشر

باستخدام SSH:

```bash
USE_SSH=true yarn deploy
```

دون استخدام SSH:

```bash
GIT_USER=<Your GitHub username> yarn deploy
```

إذا كنت تستخدم GitHub Pages للاستضافة، فإن هذا الأمر طريقة ملائمة لبناء الموقع ودفعه (push) إلى الفرع `gh-pages`.

## إعداد البحث

يتضمّن الموقع بحثًا محليًا في التوثيق يعمل دون أي خدمات خارجية، بحيث تتضمّن بيئة التطوير المحلية وعمليات نشر المعاينة دائمًا شريط بحث يعمل. وعند توفّر بيانات اعتماد حقيقية لـ Algolia DocSearch، ننتقل تلقائيًا إلى Algolia. أصبحت ميزة Ask AI الآن تُضبط بشكل منفصل، بحيث يمكنك تفعيل بحث Algolia دون Ask AI أو العكس، بحسب بيانات الاعتماد التي تقدّمها. وتعتمد التجربة المدعومة من Algolia زرّ تشغيل على شكل حبّة (pill) مستوحى من React.dev، مع شارة مخصّصة لـ Ask AI، حتى يكتشف الزوّار فورًا متى تكون الإجابات الحوارية متاحة.

أنشئ ملف `.env` (أو صدِّر المتغيرات في الصدفة (shell) الخاصة بك) بالقيم التالية لتفعيل بحث Algolia وAsk AI:

```bash
ALGOLIA_APP_ID="..."
ALGOLIA_API_KEY="..." # Search-only API key
ALGOLIA_INDEX_NAME="..."

# Optional Ask AI configuration
ALGOLIA_ASSISTANT_ID="..." # Algolia Ask AI assistant identifier

# Optional overrides if your Ask AI integration uses a dedicated application or index
# ALGOLIA_AI_APP_ID="..."
# ALGOLIA_AI_API_KEY="..."
# ALGOLIA_AI_INDEX_NAME="..."
```

لا تضبط متغيرات Ask AI إلا عندما يكون تطبيق DocSearch الخاص بك مُعدًّا لهذه التجربة؛ وإلا فيمكن تركها دون تعيين. ومن دون هذه المتغيرات، يواصل الموقع استخدام البحث المحلي المضمَّن في التوثيق (أو Algolia، إذا قُدّمت بيانات الاعتماد الخاصة به) دون محاولة تفعيل Ask AI. وعندما تتوفّر بيانات اعتماد Algolia ومساعد Ask AI معًا، يربط الإعداد المساعدَ تلقائيًا بـ DocSearch بحيث يمكن للنافذة المنبثقة (modal) أن تُظهر اللوحة الحوارية تمامًا كما في تجربة React.dev. أمّا ترك حقول Ask AI فارغة مع تقديم بيانات اعتماد Algolia فينتج عنه واجهة DocSearch التقليدية وحدها.
69 changes: 69 additions & 0 deletions README.es.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
> Traducción comunitaria (borrador) — Política P2-002 de NTARI, Difusión Multilingüe Global. Fuente: README.md (original en inglés, instantánea del 2026-10-05). Borrador comunitario asistido por máquina, pendiente de revisión por el mantenedor regional según P2-002 §3.1. Las especificaciones técnicas centrales permanecen en inglés según §2.2.
>
> ¿Encontraste un error en esta traducción? Tu corrección es una contribución
> bienvenida y valorada: haz un fork del repositorio y abre un pull request en
> https://github.com/NTARI-RAND/agrinet-docs.

# Sitio web

Este sitio web está construido con [Docusaurus](https://docusaurus.io/), un generador moderno de sitios web estáticos.

## Instalación

```bash
yarn
```

## Desarrollo local

```bash
yarn start
```

Este comando inicia un servidor de desarrollo local y abre una ventana del navegador. La mayoría de los cambios se reflejan en vivo sin necesidad de reiniciar el servidor.

## Compilación

```bash
yarn build
```

Este comando genera contenido estático en el directorio `build`, que puede servirse con cualquier servicio de alojamiento de contenido estático.

## Despliegue

Usando SSH:

```bash
USE_SSH=true yarn deploy
```

Sin usar SSH:

```bash
GIT_USER=<Your GitHub username> yarn deploy
```

Si usas GitHub Pages para el alojamiento, este comando es una forma práctica de compilar el sitio web y publicarlo (push) en la rama `gh-pages`.

## Configuración de la búsqueda

El sitio incluye una búsqueda local de la documentación que funciona sin ningún servicio externo, de modo que el desarrollo local y los despliegues de vista previa siempre incluyen una barra de búsqueda funcional. Cuando hay credenciales reales de Algolia DocSearch, cambiamos automáticamente a Algolia. Ask AI ahora se configura por separado, así que puedes habilitar la búsqueda de Algolia sin Ask AI, o viceversa, según las credenciales que proporciones. La experiencia impulsada por Algolia adopta un activador en forma de píldora inspirado en React.dev, con una insignia dedicada de Ask AI, para que los visitantes descubran de inmediato cuándo hay respuestas conversacionales disponibles.

Crea un archivo `.env` (o exporta las variables en tu shell) con los siguientes valores para habilitar la búsqueda de Algolia y Ask AI:

```bash
ALGOLIA_APP_ID="..."
ALGOLIA_API_KEY="..." # Search-only API key
ALGOLIA_INDEX_NAME="..."

# Optional Ask AI configuration
ALGOLIA_ASSISTANT_ID="..." # Algolia Ask AI assistant identifier

# Optional overrides if your Ask AI integration uses a dedicated application or index
# ALGOLIA_AI_APP_ID="..."
# ALGOLIA_AI_API_KEY="..."
# ALGOLIA_AI_INDEX_NAME="..."
```

Define las variables de Ask AI solo cuando tu aplicación de DocSearch esté configurada para esa experiencia; de lo contrario, pueden dejarse sin definir. Sin esas variables, el sitio sigue usando la búsqueda local de la documentación incluida (o Algolia, si se proporcionan esas credenciales) sin intentar activar Ask AI. Cuando están presentes tanto las credenciales de Algolia como un asistente de Ask AI, la configuración conecta automáticamente el asistente con DocSearch para que el modal pueda mostrar el panel conversacional, igual que en la experiencia de React.dev. Dejar vacíos los campos de Ask AI mientras se siguen proporcionando credenciales de Algolia produce la interfaz tradicional solo con DocSearch.
74 changes: 74 additions & 0 deletions README.fr.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
> Traduction communautaire (brouillon) — politique NTARI P2-002, Diffusion
> multilingue mondiale. Source : README.md (original anglais, instantané du
> 2026-10-05). Brouillon communautaire assisté par machine, en attente de
> relecture par le mainteneur régional conformément au P2-002 §3.1. Les
> spécifications techniques de base restent en anglais conformément au §2.2.
>
> Vous avez remarqué une erreur de traduction ? N'hésitez pas à la corriger
> vous-même : forkez le dépôt https://github.com/NTARI-RAND/agrinet-docs et ouvrez
> une pull request. Les corrections de traduction sont des contributions
> précieuses, tout autant que le code.

# Site web

Ce site web est construit avec [Docusaurus](https://docusaurus.io/), un générateur moderne de sites web statiques.

## Installation

```bash
yarn
```

## Développement local

```bash
yarn start
```

Cette commande démarre un serveur de développement local et ouvre une fenêtre de navigateur. La plupart des modifications sont prises en compte en direct, sans qu'il soit nécessaire de redémarrer le serveur.

## Construction

```bash
yarn build
```

Cette commande génère le contenu statique dans le répertoire `build`, qui peut ensuite être servi par n'importe quel service d'hébergement de contenu statique.

## Déploiement

Avec SSH :

```bash
USE_SSH=true yarn deploy
```

Sans SSH :

```bash
GIT_USER=<Your GitHub username> yarn deploy
```

Si vous utilisez GitHub Pages pour l'hébergement, cette commande est un moyen pratique de construire le site web et de le pousser vers la branche `gh-pages`.

## Configuration de la recherche

Le site intègre une recherche locale dans la documentation qui fonctionne sans aucun service externe, de sorte que le développement local et les déploiements de prévisualisation disposent toujours d'une barre de recherche fonctionnelle. Lorsque de véritables identifiants Algolia DocSearch sont présents, nous basculons automatiquement vers Algolia. Ask AI est désormais configuré séparément : vous pouvez donc activer la recherche Algolia sans Ask AI, ou inversement, selon les identifiants que vous fournissez. L'expérience propulsée par Algolia adopte un déclencheur en forme de pilule inspiré de React.dev, avec un badge Ask AI dédié, afin que les visiteurs découvrent immédiatement quand des réponses conversationnelles sont disponibles.

Créez un fichier `.env` (ou exportez les variables dans votre shell) avec les valeurs suivantes pour activer la recherche Algolia et Ask AI :

```bash
ALGOLIA_APP_ID="..."
ALGOLIA_API_KEY="..." # Search-only API key
ALGOLIA_INDEX_NAME="..."

# Optional Ask AI configuration
ALGOLIA_ASSISTANT_ID="..." # Algolia Ask AI assistant identifier

# Optional overrides if your Ask AI integration uses a dedicated application or index
# ALGOLIA_AI_APP_ID="..."
# ALGOLIA_AI_API_KEY="..."
# ALGOLIA_AI_INDEX_NAME="..."
```

Ne définissez les variables Ask AI que si votre application DocSearch est configurée pour cette expérience ; sinon, elles peuvent rester non définies. Sans ces variables, le site continue d'utiliser la recherche locale intégrée dans la documentation (ou Algolia, si ces identifiants sont fournis) sans tenter d'activer Ask AI. Lorsque les identifiants Algolia et un assistant Ask AI sont tous deux présents, la configuration connecte automatiquement l'assistant à DocSearch, afin que la fenêtre modale puisse afficher le panneau conversationnel, exactement comme dans l'expérience React.dev. Laisser les champs Ask AI vides tout en fournissant des identifiants Algolia produit l'interface traditionnelle limitée à DocSearch.
70 changes: 70 additions & 0 deletions README.hi.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
> सामुदायिक अनुवाद (प्रारूप) — NTARI नीति P2-002, Global Multilingual Broadcast। स्रोत: README.md (अंग्रेज़ी मूल, स्नैपशॉट 2026-10-05)। P2-002 §3.1 के अनुसार क्षेत्रीय मेंटेनर की समीक्षा हेतु लंबित, मशीन-सहायता से तैयार सामुदायिक प्रारूप। मूल तकनीकी विनिर्देश §2.2 के अनुसार अंग्रेज़ी में ही रहते हैं।
>
> अनुवाद में कोई त्रुटि दिखे तो कृपया उसे स्वयं सुधारने में मदद करें:
> रिपॉज़िटरी को फ़ॉर्क (fork) करें और अपना सुधार पुल रिक्वेस्ट (pull request)
> के रूप में भेजें — https://github.com/NTARI-RAND/agrinet-docs। अनुवाद-सुधार हमारे
> लिए किसी भी अन्य योगदान जितने ही मूल्यवान हैं, और उनका सदा स्वागत है।

# वेबसाइट

यह वेबसाइट [Docusaurus](https://docusaurus.io/) का उपयोग करके बनाई गई है, जो एक आधुनिक स्टैटिक वेबसाइट जनरेटर है।

## इंस्टॉलेशन

```bash
yarn
```

## स्थानीय विकास

```bash
yarn start
```

यह कमांड एक स्थानीय डेवलपमेंट सर्वर शुरू करता है और एक ब्राउज़र विंडो खोलता है। अधिकांश बदलाव सर्वर को पुनः आरंभ किए बिना तुरंत (लाइव) दिखाई देते हैं।

## बिल्ड

```bash
yarn build
```

यह कमांड `build` डायरेक्टरी में स्टैटिक सामग्री तैयार करता है, जिसे किसी भी स्टैटिक सामग्री होस्टिंग सेवा के माध्यम से सर्व किया जा सकता है।

## डिप्लॉयमेंट

SSH का उपयोग करते हुए:

```bash
USE_SSH=true yarn deploy
```

SSH का उपयोग किए बिना:

```bash
GIT_USER=<Your GitHub username> yarn deploy
```

यदि आप होस्टिंग के लिए GitHub pages का उपयोग कर रहे हैं, तो यह कमांड वेबसाइट को बिल्ड करने और `gh-pages` ब्रांच पर पुश करने का एक सुविधाजनक तरीका है।

## खोज कॉन्फ़िगरेशन

साइट में एक स्थानीय दस्तावेज़ीकरण खोज शामिल है जो किसी भी बाहरी सेवा के बिना काम करती है, ताकि स्थानीय विकास और प्रीव्यू डिप्लॉयमेंट में हमेशा एक काम करने वाला सर्च बार मौजूद रहे। जब वास्तविक Algolia DocSearch क्रेडेंशियल मौजूद होते हैं, तो हम स्वचालित रूप से Algolia पर स्विच कर जाते हैं। Ask AI अब अलग से कॉन्फ़िगर किया जाता है, ताकि आप जो क्रेडेंशियल देते हैं उनके आधार पर Ask AI के बिना Algolia खोज, या इसका उलटा, सक्षम कर सकें। Algolia-संचालित अनुभव React.dev से प्रेरित एक पिल (pill) ट्रिगर अपनाता है, जिसमें एक समर्पित Ask AI बैज होता है, ताकि आगंतुकों को तुरंत पता चल जाए कि संवादात्मक उत्तर कब उपलब्ध हैं।

Algolia खोज और Ask AI को सक्षम करने के लिए निम्नलिखित मानों के साथ एक `.env` फ़ाइल बनाएँ (या अपने शेल में वेरिएबल एक्सपोर्ट करें):

```bash
ALGOLIA_APP_ID="..."
ALGOLIA_API_KEY="..." # Search-only API key
ALGOLIA_INDEX_NAME="..."

# Optional Ask AI configuration
ALGOLIA_ASSISTANT_ID="..." # Algolia Ask AI assistant identifier

# Optional overrides if your Ask AI integration uses a dedicated application or index
# ALGOLIA_AI_APP_ID="..."
# ALGOLIA_AI_API_KEY="..."
# ALGOLIA_AI_INDEX_NAME="..."
```

Ask AI वेरिएबल केवल तभी सेट करें जब आपका DocSearch एप्लिकेशन इस अनुभव के लिए कॉन्फ़िगर किया गया हो; अन्यथा उन्हें बिना सेट किए छोड़ा जा सकता है। इन वेरिएबल के बिना, साइट Ask AI को सक्रिय करने का प्रयास किए बिना शामिल स्थानीय दस्तावेज़ीकरण खोज (या, यदि वे क्रेडेंशियल दिए गए हों, तो Algolia) का ही उपयोग करती रहती है। जब Algolia क्रेडेंशियल और एक Ask AI असिस्टेंट दोनों मौजूद होते हैं, तो कॉन्फ़िगरेशन स्वचालित रूप से असिस्टेंट को DocSearch से जोड़ देता है, ताकि मोडल ठीक React.dev अनुभव की तरह संवादात्मक पैनल दिखा सके। Algolia क्रेडेंशियल देते हुए भी Ask AI फ़ील्ड खाली छोड़ने पर पारंपरिक, केवल-DocSearch वाला UI मिलता है।
Loading
Loading