diff --git a/README.ar.md b/README.ar.md new file mode 100644 index 00000000..85aa76ce --- /dev/null +++ b/README.ar.md @@ -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= 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 التقليدية وحدها. diff --git a/README.es.md b/README.es.md new file mode 100644 index 00000000..fd07184f --- /dev/null +++ b/README.es.md @@ -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= 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. diff --git a/README.fr.md b/README.fr.md new file mode 100644 index 00000000..fed3548f --- /dev/null +++ b/README.fr.md @@ -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= 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. diff --git a/README.hi.md b/README.hi.md new file mode 100644 index 00000000..b6bf6ca0 --- /dev/null +++ b/README.hi.md @@ -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= 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 मिलता है। diff --git a/README.pt.md b/README.pt.md new file mode 100644 index 00000000..607b0631 --- /dev/null +++ b/README.pt.md @@ -0,0 +1,69 @@ +> Tradução comunitária (rascunho) — política P2-002 da NTARI, Transmissão Multilíngue Global. Fonte: README.md (original em inglês, snapshot de 2026-10-05). Rascunho comunitário assistido por máquina, pendente de revisão do mantenedor regional conforme P2-002 §3.1. As especificações técnicas centrais permanecem em inglês conforme §2.2. +> +> Notou algum erro nesta tradução? Correções de tradução são contribuições +> valiosas e muito bem-vindas: faça um fork do repositório e abra um pull +> request em https://github.com/NTARI-RAND/agrinet-docs. + +# Site + +Este site é construído com o [Docusaurus](https://docusaurus.io/), um gerador moderno de sites estáticos. + +## Instalação + +```bash +yarn +``` + +## Desenvolvimento local + +```bash +yarn start +``` + +Este comando inicia um servidor de desenvolvimento local e abre uma janela do navegador. A maioria das alterações é refletida ao vivo, sem necessidade de reiniciar o servidor. + +## Build + +```bash +yarn build +``` + +Este comando gera conteúdo estático no diretório `build`, que pode ser servido por qualquer serviço de hospedagem de conteúdo estático. + +## Implantação + +Usando SSH: + +```bash +USE_SSH=true yarn deploy +``` + +Sem usar SSH: + +```bash +GIT_USER= yarn deploy +``` + +Se você usa o GitHub Pages para hospedagem, este comando é uma forma prática de construir o site e enviá-lo (push) para o branch `gh-pages`. + +## Configuração da busca + +O site inclui uma busca local na documentação que funciona sem nenhum serviço externo, de modo que o desenvolvimento local e as implantações de pré-visualização sempre contam com uma barra de busca funcional. Quando credenciais reais do Algolia DocSearch estão presentes, passamos automaticamente a usar o Algolia. O Ask AI agora é configurado separadamente, para que você possa ativar a busca do Algolia sem o Ask AI ou vice-versa, conforme as credenciais que fornecer. A experiência baseada no Algolia adota um acionador em formato de pílula inspirado no React.dev, com um selo dedicado do Ask AI, para que os visitantes descubram imediatamente quando respostas conversacionais estão disponíveis. + +Crie um arquivo `.env` (ou exporte as variáveis no seu shell) com os seguintes valores para ativar a busca do Algolia e o 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="..." +``` + +Defina as variáveis do Ask AI somente quando a sua aplicação DocSearch estiver configurada para essa experiência; caso contrário, elas podem ficar sem definição. Sem as variáveis, o site continua usando a busca local embutida na documentação (ou o Algolia, se essas credenciais forem fornecidas), sem tentar ativar o Ask AI. Quando tanto as credenciais do Algolia quanto um assistente do Ask AI estão presentes, a configuração conecta automaticamente o assistente ao DocSearch, para que o modal possa exibir o painel conversacional, exatamente como na experiência do React.dev. Deixar os campos do Ask AI vazios e, ainda assim, fornecer as credenciais do Algolia resulta na interface tradicional somente com o DocSearch. diff --git a/README.tok.md b/README.tok.md new file mode 100644 index 00000000..838753c4 --- /dev/null +++ b/README.tok.md @@ -0,0 +1,77 @@ +# lipu linluwi + +> **toki pona:** lipu ni li lipu lili pi kulupu, tan nasin NTARI "P2-002". lipu +> ale li lipu "README.md" pi toki Inli (tenpo pi sitelen: 2026-10-05). ilo sona +> li pali e lipu ni, la kulupu o lukin o pona e ona, tan nasin "P2-002" kipisi +> nanpa 3.1. +> +> **English:** This is a condensed community rendering under NTARI policy +> P2-002. The complete document is the English original README.md (snapshot +> 2026-10-05). Machine-assisted draft pending community review per P2-002 +> section 3.1. +> +> sina lukin e pakala lon toki ni la o pona e ona: o pali e "fork" lon +> https://github.com/NTARI-RAND/agrinet-docs, o pana e "pull request". pana sina li +> pona tawa mi mute. + +lipu linluwi ni li kama kepeken [ilo "Docusaurus"](https://docusaurus.io/). ilo ni li ilo sin. ona li pali e lipu linluwi pi ante ala. + +## o pana e ilo + +```bash +yarn +``` + +## pali lon ilo sina + +```bash +yarn start +``` + +toki wawa ni li open e ilo pana lon ilo sina, li open e lupa pi ilo lukin linluwi. ante mute li kama lon lukin lon tenpo sama. sina wile ala open sin e ilo pana. + +## o pali e lipu + +```bash +yarn build +``` + +toki wawa ni li pali e lipu pi ante ala lon poki `build`. ilo pana ale pi lipu pi ante ala li ken pana e ona. + +## o pana e lipu tawa linluwi + +kepeken nasin "SSH": + +```bash +USE_SSH=true yarn deploy +``` + +kepeken ala nasin "SSH": + +```bash +GIT_USER= yarn deploy +``` + +sina kepeken ilo "GitHub Pages" tawa pana lipu la, toki wawa ni li nasin pona: ona li pali e lipu linluwi, li pana e ona tawa linja `gh-pages`. + +## nasin pi ilo alasa + +lipu linluwi li jo e ilo alasa lipu lon ilo sina. ilo ni li wile ala e ilo ante tan ma ante. tan ni la, pali lon ilo sina en lipu lukin pi tenpo lili li jo e linja alasa pona lon tenpo ale. sona open lon pi ilo "Algolia DocSearch" li lon la, mi mute li ante tawa ilo "Algolia". ilo li pali e ni kepeken wile ona. lon tenpo ni la, jan li pana e nasin pi ilo "Ask AI" lon poka ante. tan ni la, sina ken open e alasa "Algolia" taso, anu ilo "Ask AI" taso. ni li tan sona open pi pana sina. lukin pi ilo "Algolia" li kepeken nena sike, tan lukin pi nasin "React.dev". nena ni li jo e sitelen lili "Ask AI" pi ona taso. tan ni la jan lukin li sona lon tenpo sama e ni: ilo li ken toki sama jan, li ken pana e toki pi pana sona. + +o pali e lipu `.env` (anu o pana e ijo ante ni lon ilo pi toki wawa sina) kepeken nanpa ni, tawa open pi alasa "Algolia" en ilo "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="..." +``` + +sina o pana e ijo ante pi ilo "Ask AI" lon tenpo ni taso: ilo "DocSearch" sina li jo e nasin tawa lukin ni. ante la sina ken pana ala e ona. ijo ante ni li lon ala la, lipu linluwi li awen kepeken ilo alasa lipu lon ilo sina (anu ilo "Algolia", sina pana e sona open ona la), li alasa ala open e ilo "Ask AI". sona open pi ilo "Algolia" en ilo pali "Ask AI" li lon la, nasin li wan e ilo pali tawa ilo "DocSearch" kepeken wile ona. tan ni la, lupa lili li ken pana e kipisi pi toki sama jan, sama lukin pi nasin "React.dev". sina pana e sona open pi ilo "Algolia", taso sina pana ala e ijo "Ask AI" la, ilo li pana e lukin "DocSearch" taso pi tenpo pini. diff --git a/README.zh.md b/README.zh.md new file mode 100644 index 00000000..cfac336a --- /dev/null +++ b/README.zh.md @@ -0,0 +1,68 @@ +> 社区翻译(草稿)—— 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= yarn deploy +``` + +如果您使用 GitHub Pages 进行托管,此命令可以便捷地构建网站并推送到 `gh-pages` 分支。 + +## 搜索配置 + +本站点内置了一个本地文档搜索功能,无需任何外部服务即可运行,因此本地开发和预览部署始终带有可用的搜索栏。当存在真实的 Algolia DocSearch 凭据时,我们会自动切换到 Algolia。Ask AI 现在单独配置,因此您可以根据所提供的凭据,只启用 Algolia 搜索而不启用 Ask AI,反之亦然。由 Algolia 驱动的搜索体验采用受 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="..." +``` + +仅当您的 DocSearch 应用已为该体验完成配置时,才需设置 Ask AI 变量;否则可以不设置。在没有这些变量的情况下,站点会继续使用内置的本地文档搜索(如果提供了 Algolia 凭据,则使用 Algolia),而不会尝试激活 Ask AI。当 Algolia 凭据和 Ask AI 助手同时存在时,配置会自动将该助手接入 DocSearch,使搜索弹窗能够像 React.dev 的体验一样显示对话面板。如果提供了 Algolia 凭据但将 Ask AI 字段留空,则会得到传统的仅 DocSearch 界面。