From ee3c00963d361afe97eaed4705afb05a7cdacc9a Mon Sep 17 00:00:00 2001 From: dockfries Date: Wed, 11 Mar 2026 23:41:46 +0800 Subject: [PATCH 01/24] fix changelog compare link --- frontend/content/releases/server/v1.1.0.2612.md | 2 +- frontend/content/releases/server/v1.3.1.2748.md | 2 +- frontend/content/releases/server/v1.4.0.2779.md | 2 +- frontend/content/releases/server/v1.5.8.3079.md | 2 +- frontend/i18n/pt-BR/content/releases/server/v1.1.0.2612.md | 2 +- frontend/i18n/pt-BR/content/releases/server/v1.3.1.2748.md | 2 +- frontend/i18n/pt-BR/content/releases/server/v1.4.0.2779.md | 2 +- frontend/i18n/pt-BR/content/releases/server/v1.5.8.3079.md | 2 +- frontend/i18n/zh-CN/content/releases/server/v1.4.0.2779.md | 2 +- 9 files changed, 9 insertions(+), 9 deletions(-) diff --git a/frontend/content/releases/server/v1.1.0.2612.md b/frontend/content/releases/server/v1.1.0.2612.md index a53ea2c5a9f..7b37223a59e 100644 --- a/frontend/content/releases/server/v1.1.0.2612.md +++ b/frontend/content/releases/server/v1.1.0.2612.md @@ -108,4 +108,4 @@ There are so many fixes and additions, for those who don't know, they can read b * @Zorono made their first contribution in https://github.com/openmultiplayer/open.mp/pull/752 * @ReshiramZekrom1 made their first contribution in https://github.com/openmultiplayer/open.mp/pull/762 -**Full Changelog**: https://github.com/openmultiplayer/open.mp/compare/v0.0.11.2331...v1.1.0 +**Full Changelog**: https://github.com/openmultiplayer/open.mp/compare/v0.0.11.2331...v1.1.0.2612 diff --git a/frontend/content/releases/server/v1.3.1.2748.md b/frontend/content/releases/server/v1.3.1.2748.md index e13eb30aff9..9547bcdca2a 100644 --- a/frontend/content/releases/server/v1.3.1.2748.md +++ b/frontend/content/releases/server/v1.3.1.2748.md @@ -76,4 +76,4 @@ assets: * @myudev made their first contribution in https://github.com/openmultiplayer/open.mp/pull/919 * @atomlin-git made their first contribution in https://github.com/openmultiplayer/open.mp/pull/902 -**Full Changelog**: https://github.com/openmultiplayer/open.mp/compare/v1.2.0.2670...v1.3.1.2744 +**Full Changelog**: https://github.com/openmultiplayer/open.mp/compare/v1.2.0.2670...v1.3.1.2748 diff --git a/frontend/content/releases/server/v1.4.0.2779.md b/frontend/content/releases/server/v1.4.0.2779.md index 8b309a69bbf..7264d2e9593 100644 --- a/frontend/content/releases/server/v1.4.0.2779.md +++ b/frontend/content/releases/server/v1.4.0.2779.md @@ -59,4 +59,4 @@ assets: ## New Contributors * @f0Re3t made their first contribution in https://github.com/openmultiplayer/open.mp/pull/978 -**Full Changelog**: https://github.com/openmultiplayer/open.mp/compare/v1.3.1.2744...v1.4.0.2779 +**Full Changelog**: https://github.com/openmultiplayer/open.mp/compare/v1.3.1.2748...v1.4.0.2779 diff --git a/frontend/content/releases/server/v1.5.8.3079.md b/frontend/content/releases/server/v1.5.8.3079.md index b603c5d9af8..b57cee3d8b8 100644 --- a/frontend/content/releases/server/v1.5.8.3079.md +++ b/frontend/content/releases/server/v1.5.8.3079.md @@ -111,4 +111,4 @@ assets: * @Tiaansu made their first contribution in https://github.com/openmultiplayer/open.mp/pull/1151 * @nidi21 made their first contribution in https://github.com/openmultiplayer/open.mp/pull/1152 -**Full Changelog**: https://github.com/openmultiplayer/open.mp/compare/v1.4.0.2779...v1.5.8.3077 +**Full Changelog**: https://github.com/openmultiplayer/open.mp/compare/v1.4.0.2779...v1.5.8.3079 diff --git a/frontend/i18n/pt-BR/content/releases/server/v1.1.0.2612.md b/frontend/i18n/pt-BR/content/releases/server/v1.1.0.2612.md index d2f669dc088..1984971beac 100644 --- a/frontend/i18n/pt-BR/content/releases/server/v1.1.0.2612.md +++ b/frontend/i18n/pt-BR/content/releases/server/v1.1.0.2612.md @@ -108,4 +108,4 @@ Há muitas correções e adições, para aqueles que não sabem, podem ler abaix * @Zorono fez sua primeira contribuição em https://github.com/openmultiplayer/open.mp/pull/752 * @ReshiramZekrom1 fez sua primeira contribuição em https://github.com/openmultiplayer/open.mp/pull/762 -**Changelog completo**: https://github.com/openmultiplayer/open.mp/compare/v0.0.11.2331...v1.1.0 +**Changelog completo**: https://github.com/openmultiplayer/open.mp/compare/v0.0.11.2331...v1.1.0.2612 diff --git a/frontend/i18n/pt-BR/content/releases/server/v1.3.1.2748.md b/frontend/i18n/pt-BR/content/releases/server/v1.3.1.2748.md index 37ef78197de..40fc08b7e24 100644 --- a/frontend/i18n/pt-BR/content/releases/server/v1.3.1.2748.md +++ b/frontend/i18n/pt-BR/content/releases/server/v1.3.1.2748.md @@ -76,4 +76,4 @@ assets: * @myudev fez sua primeira contribuição em https://github.com/openmultiplayer/open.mp/pull/919 * @atomlin-git fez sua primeira contribuição em https://github.com/openmultiplayer/open.mp/pull/902 -**Changelog completo**: https://github.com/openmultiplayer/open.mp/compare/v1.2.0.2670...v1.3.1.2744 +**Changelog completo**: https://github.com/openmultiplayer/open.mp/compare/v1.2.0.2670...v1.3.1.2748 diff --git a/frontend/i18n/pt-BR/content/releases/server/v1.4.0.2779.md b/frontend/i18n/pt-BR/content/releases/server/v1.4.0.2779.md index 55750c488e4..547b616e068 100644 --- a/frontend/i18n/pt-BR/content/releases/server/v1.4.0.2779.md +++ b/frontend/i18n/pt-BR/content/releases/server/v1.4.0.2779.md @@ -59,4 +59,4 @@ assets: ## Novos Colaboradores * @f0Re3t fez sua primeira contribuição em https://github.com/openmultiplayer/open.mp/pull/978 -**Changelog completo**: https://github.com/openmultiplayer/open.mp/compare/v1.3.1.2744...v1.4.0.2779 +**Changelog completo**: https://github.com/openmultiplayer/open.mp/compare/v1.3.1.2748...v1.4.0.2779 diff --git a/frontend/i18n/pt-BR/content/releases/server/v1.5.8.3079.md b/frontend/i18n/pt-BR/content/releases/server/v1.5.8.3079.md index 539335c0ace..d54bddafed5 100644 --- a/frontend/i18n/pt-BR/content/releases/server/v1.5.8.3079.md +++ b/frontend/i18n/pt-BR/content/releases/server/v1.5.8.3079.md @@ -111,4 +111,4 @@ assets: * @Tiaansu fez sua primeira contribuição em https://github.com/openmultiplayer/open.mp/pull/1151 * @nidi21 fez sua primeira contribuição em https://github.com/openmultiplayer/open.mp/pull/1152 -**Changelog completo**: https://github.com/openmultiplayer/open.mp/compare/v1.4.0.2779...v1.5.8.3077 +**Changelog completo**: https://github.com/openmultiplayer/open.mp/compare/v1.4.0.2779...v1.5.8.3079 diff --git a/frontend/i18n/zh-CN/content/releases/server/v1.4.0.2779.md b/frontend/i18n/zh-CN/content/releases/server/v1.4.0.2779.md index 79076f32b74..2d76ae154a3 100644 --- a/frontend/i18n/zh-CN/content/releases/server/v1.4.0.2779.md +++ b/frontend/i18n/zh-CN/content/releases/server/v1.4.0.2779.md @@ -62,4 +62,4 @@ assets: - @f0Re3t 在 https://github.com/openmultiplayer/open.mp/pull/978 首次贡献 -**完整更新日志**：https://github.com/openmultiplayer/open.mp/compare/v1.3.1.2744...v1.4.0.2779 +**完整更新日志**：https://github.com/openmultiplayer/open.mp/compare/v1.3.1.2748...v1.4.0.2779 From c1a60da4d8f0d60d02356b0f7f5e6a0708f0c0b9 Mon Sep 17 00:00:00 2001 From: dockfries Date: Thu, 12 Mar 2026 00:04:29 +0800 Subject: [PATCH 02/24] use relative link for changelog announcement --- frontend/src/pages/index.tsx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/frontend/src/pages/index.tsx b/frontend/src/pages/index.tsx index a85ad399795..265f8065474 100644 --- a/frontend/src/pages/index.tsx +++ b/frontend/src/pages/index.tsx @@ -107,7 +107,7 @@ const HomepageHeader = () => { {'Version {version} of open.mp server is out with many fixes, performance boosts, and new features!'} {" "} Changelog From b45aedd9a1c223a318e347865814f286291a15ac Mon Sep 17 00:00:00 2001 From: dockfries Date: Thu, 12 Mar 2026 00:36:40 +0800 Subject: [PATCH 03/24] remove `_.md`, use `current.json` for i18n sidebar category labels --- frontend/docs/client/_.md | 7 ---- frontend/docs/tutorials/_.md | 7 ---- .../current.json | 32 +++++++++++++++++++ .../current.json | 32 +++++++++++++++++++ .../current.json | 32 +++++++++++++++++++ .../current/client/_.md | 7 ---- .../current.json | 32 +++++++++++++++++++ .../current/tutorials/_.md | 7 ---- .../current.json | 32 +++++++++++++++++++ .../current/client/_.md | 7 ---- .../current/tutorials/_.md | 7 ---- .../current.json | 32 +++++++++++++++++++ .../current.json | 32 +++++++++++++++++++ .../current/client/_.md | 7 ---- .../current.json | 32 +++++++++++++++++++ .../current.json | 32 +++++++++++++++++++ .../current/client/_.md | 7 ---- .../current/tutorials/_.md | 7 ---- .../current.json | 32 +++++++++++++++++++ .../current.json | 32 +++++++++++++++++++ .../current/client/_.md | 8 ----- .../current/tutorials/_.md | 9 ------ .../current.json | 32 +++++++++++++++++++ .../current.json | 32 +++++++++++++++++++ .../current/client/_.md | 7 ---- .../current/tutorials/_.md | 7 ---- .../current.json | 32 +++++++++++++++++++ .../current/tutorials/_.md | 7 ---- .../current.json | 32 +++++++++++++++++++ .../current/client/_.md | 7 ---- .../current/tutorials/_.md | 7 ---- .../current.json | 32 +++++++++++++++++++ .../current.json | 32 +++++++++++++++++++ .../current/client/_.md | 7 ---- .../current.json | 32 +++++++++++++++++++ .../current/client/_.md | 7 ---- .../current.json | 32 +++++++++++++++++++ .../current/tutorials/_.md | 7 ---- .../current.json | 32 +++++++++++++++++++ .../current/client/_.md | 7 ---- .../current/tutorials/_.md | 7 ---- .../current.json | 32 +++++++++++++++++++ .../current/client/_.md | 7 ---- .../current.json | 32 +++++++++++++++++++ .../current/client/_.md | 7 ---- .../current/tutorials/_.md | 7 ---- .../current.json | 32 +++++++++++++++++++ .../current/client/_.md | 7 ---- 48 files changed, 736 insertions(+), 178 deletions(-) delete mode 100644 frontend/docs/client/_.md delete mode 100644 frontend/docs/tutorials/_.md create mode 100644 frontend/i18n/ar/docusaurus-plugin-content-docs/current.json create mode 100644 frontend/i18n/bs/docusaurus-plugin-content-docs/current.json create mode 100644 frontend/i18n/de/docusaurus-plugin-content-docs/current.json delete mode 100644 frontend/i18n/de/docusaurus-plugin-content-docs/current/client/_.md create mode 100644 frontend/i18n/es/docusaurus-plugin-content-docs/current.json delete mode 100644 frontend/i18n/es/docusaurus-plugin-content-docs/current/tutorials/_.md create mode 100644 frontend/i18n/fa/docusaurus-plugin-content-docs/current.json delete mode 100644 frontend/i18n/fa/docusaurus-plugin-content-docs/current/client/_.md delete mode 100644 frontend/i18n/fa/docusaurus-plugin-content-docs/current/tutorials/_.md create mode 100644 frontend/i18n/fil/docusaurus-plugin-content-docs/current.json create mode 100644 frontend/i18n/fr/docusaurus-plugin-content-docs/current.json delete mode 100644 frontend/i18n/fr/docusaurus-plugin-content-docs/current/client/_.md create mode 100644 frontend/i18n/hu/docusaurus-plugin-content-docs/current.json create mode 100644 frontend/i18n/id/docusaurus-plugin-content-docs/current.json delete mode 100644 frontend/i18n/id/docusaurus-plugin-content-docs/current/client/_.md delete mode 100644 frontend/i18n/id/docusaurus-plugin-content-docs/current/tutorials/_.md create mode 100644 frontend/i18n/it/docusaurus-plugin-content-docs/current.json create mode 100644 frontend/i18n/nl/docusaurus-plugin-content-docs/current.json delete mode 100644 frontend/i18n/nl/docusaurus-plugin-content-docs/current/client/_.md delete mode 100644 frontend/i18n/nl/docusaurus-plugin-content-docs/current/tutorials/_.md create mode 100644 frontend/i18n/pl/docusaurus-plugin-content-docs/current.json create mode 100644 frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current.json delete mode 100644 frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/client/_.md delete mode 100644 frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/tutorials/_.md create mode 100644 frontend/i18n/ro/docusaurus-plugin-content-docs/current.json delete mode 100644 frontend/i18n/ro/docusaurus-plugin-content-docs/current/tutorials/_.md create mode 100644 frontend/i18n/ru/docusaurus-plugin-content-docs/current.json delete mode 100644 frontend/i18n/ru/docusaurus-plugin-content-docs/current/client/_.md delete mode 100644 frontend/i18n/ru/docusaurus-plugin-content-docs/current/tutorials/_.md create mode 100644 frontend/i18n/sl/docusaurus-plugin-content-docs/current.json create mode 100644 frontend/i18n/sr/docusaurus-plugin-content-docs/current.json delete mode 100644 frontend/i18n/sr/docusaurus-plugin-content-docs/current/client/_.md create mode 100644 frontend/i18n/ta/docusaurus-plugin-content-docs/current.json delete mode 100644 frontend/i18n/ta/docusaurus-plugin-content-docs/current/client/_.md create mode 100644 frontend/i18n/th/docusaurus-plugin-content-docs/current.json delete mode 100644 frontend/i18n/th/docusaurus-plugin-content-docs/current/tutorials/_.md create mode 100644 frontend/i18n/tr/docusaurus-plugin-content-docs/current.json delete mode 100644 frontend/i18n/tr/docusaurus-plugin-content-docs/current/client/_.md delete mode 100644 frontend/i18n/tr/docusaurus-plugin-content-docs/current/tutorials/_.md create mode 100644 frontend/i18n/vi/docusaurus-plugin-content-docs/current.json delete mode 100644 frontend/i18n/vi/docusaurus-plugin-content-docs/current/client/_.md create mode 100644 frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current.json delete mode 100644 frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/client/_.md delete mode 100644 frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/_.md create mode 100644 frontend/i18n/zh-TW/docusaurus-plugin-content-docs/current.json delete mode 100644 frontend/i18n/zh-TW/docusaurus-plugin-content-docs/current/client/_.md diff --git a/frontend/docs/client/_.md b/frontend/docs/client/_.md deleted file mode 100644 index e6dc1fedb9c..00000000000 --- a/frontend/docs/client/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Client -sidebar_label: Client -description: This category contains information about SA-MP client features and support. ---- - -This category contains information about SA-MP client features and support. diff --git a/frontend/docs/tutorials/_.md b/frontend/docs/tutorials/_.md deleted file mode 100644 index ef8fdae1532..00000000000 --- a/frontend/docs/tutorials/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Tutorials -sidebar_label: Tutorials -description: A collection of tutorials to help you write gamemodes and manage your server. ---- - -In this section, you'll find a collection of tutorials to help you write gamemodes and manage your server. They are in no particular order. diff --git a/frontend/i18n/ar/docusaurus-plugin-content-docs/current.json b/frontend/i18n/ar/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..e0817b81711 --- /dev/null +++ b/frontend/i18n/ar/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "البرمجة النصية" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "وظائف الاستدعاء" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "الدوال" + }, + "sidebar.docsSidebar.category.Language": { + "message": "اللغة" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "المراجع" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "الموارد" + }, + "sidebar.docsSidebar.category.Server": { + "message": "الخادم" + }, + "sidebar.docsSidebar.category.Client": { + "message": "العميل" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "الدروس التعليمية" + }, + "sidebar.docsSidebar.category.meta": { + "message": "ميتا" + } +} diff --git a/frontend/i18n/bs/docusaurus-plugin-content-docs/current.json b/frontend/i18n/bs/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..e484dccb838 --- /dev/null +++ b/frontend/i18n/bs/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "Skriptiranje" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "Povratni pozivi" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "Funkcije" + }, + "sidebar.docsSidebar.category.Language": { + "message": "Jezik" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "Referenca" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "Resursi" + }, + "sidebar.docsSidebar.category.Server": { + "message": "Server" + }, + "sidebar.docsSidebar.category.Client": { + "message": "Klijent" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "Tutorijali" + }, + "sidebar.docsSidebar.category.meta": { + "message": "Meta" + } +} diff --git a/frontend/i18n/de/docusaurus-plugin-content-docs/current.json b/frontend/i18n/de/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..f5c62233ee8 --- /dev/null +++ b/frontend/i18n/de/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "Skripterstellung" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "Callbacks" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "Funktionen" + }, + "sidebar.docsSidebar.category.Language": { + "message": "Sprache" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "Referenz" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "Ressourcen" + }, + "sidebar.docsSidebar.category.Server": { + "message": "Server" + }, + "sidebar.docsSidebar.category.Client": { + "message": "Client" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "Tutorials" + }, + "sidebar.docsSidebar.category.meta": { + "message": "Meta" + } +} diff --git a/frontend/i18n/de/docusaurus-plugin-content-docs/current/client/_.md b/frontend/i18n/de/docusaurus-plugin-content-docs/current/client/_.md deleted file mode 100644 index 3e78fdcbe50..00000000000 --- a/frontend/i18n/de/docusaurus-plugin-content-docs/current/client/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Client -sidebar_label: Client -description: Dieser Bereich beinhaltet Informationen über den SA-MP Client und Support. ---- - -Dieser Bereich beinhaltet Informationen über den SA-MP Client und Support. diff --git a/frontend/i18n/es/docusaurus-plugin-content-docs/current.json b/frontend/i18n/es/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..5ee109365d8 --- /dev/null +++ b/frontend/i18n/es/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "Secuencias de comandos" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "Devoluciones de llamada" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "Funciones" + }, + "sidebar.docsSidebar.category.Language": { + "message": "Lenguaje" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "Referencia" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "Recursos" + }, + "sidebar.docsSidebar.category.Server": { + "message": "Servidor" + }, + "sidebar.docsSidebar.category.Client": { + "message": "Cliente" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "Tutoriales" + }, + "sidebar.docsSidebar.category.meta": { + "message": "Meta" + } +} diff --git a/frontend/i18n/es/docusaurus-plugin-content-docs/current/tutorials/_.md b/frontend/i18n/es/docusaurus-plugin-content-docs/current/tutorials/_.md deleted file mode 100644 index ef8fdae1532..00000000000 --- a/frontend/i18n/es/docusaurus-plugin-content-docs/current/tutorials/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Tutorials -sidebar_label: Tutorials -description: A collection of tutorials to help you write gamemodes and manage your server. ---- - -In this section, you'll find a collection of tutorials to help you write gamemodes and manage your server. They are in no particular order. diff --git a/frontend/i18n/fa/docusaurus-plugin-content-docs/current.json b/frontend/i18n/fa/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..06b88ebe844 --- /dev/null +++ b/frontend/i18n/fa/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "اسکریپت نویسی" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "فراخوانی‌ها" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "توابع" + }, + "sidebar.docsSidebar.category.Language": { + "message": "زبان" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "مرجع" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "منابع" + }, + "sidebar.docsSidebar.category.Server": { + "message": "سرور" + }, + "sidebar.docsSidebar.category.Client": { + "message": "کلاینت" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "آموزش‌ها" + }, + "sidebar.docsSidebar.category.meta": { + "message": "متا" + } +} diff --git a/frontend/i18n/fa/docusaurus-plugin-content-docs/current/client/_.md b/frontend/i18n/fa/docusaurus-plugin-content-docs/current/client/_.md deleted file mode 100644 index 235c7314cff..00000000000 --- a/frontend/i18n/fa/docusaurus-plugin-content-docs/current/client/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: کلاینت -sidebar_label: کلاینت -description: این دسته شامل اطلاعات در مورد ویژگی‌ها و پشتیبانی کلاینت SA-MP است. ---- - -این دسته شامل اطلاعات در مورد ویژگی‌ها و پشتیبانی کلاینت SA-MP است. \ No newline at end of file diff --git a/frontend/i18n/fa/docusaurus-plugin-content-docs/current/tutorials/_.md b/frontend/i18n/fa/docusaurus-plugin-content-docs/current/tutorials/_.md deleted file mode 100644 index 530782d3e6e..00000000000 --- a/frontend/i18n/fa/docusaurus-plugin-content-docs/current/tutorials/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: آموزش‌ها -sidebar_label: آموزش‌ها -description: مجموعه‌ای از آموزش‌ها برای کمک به شما در نوشتن گیم مودها و مدیریت سرور. ---- - -در این بخش، مجموعه‌ای از آموزش‌ها برای کمک به شما در نوشتن گیم مودها و مدیریت سرور خواهید یافت. آنها در هیچ ترتیب خاصی نیستند. \ No newline at end of file diff --git a/frontend/i18n/fil/docusaurus-plugin-content-docs/current.json b/frontend/i18n/fil/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..8047860569c --- /dev/null +++ b/frontend/i18n/fil/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "Pagsusulat ng Script" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "Mga Callback" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "Mga Function" + }, + "sidebar.docsSidebar.category.Language": { + "message": "Wika" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "Sanggunian" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "Mga Mapagkukunan" + }, + "sidebar.docsSidebar.category.Server": { + "message": "Server" + }, + "sidebar.docsSidebar.category.Client": { + "message": "Client" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "Mga Tutorial" + }, + "sidebar.docsSidebar.category.meta": { + "message": "Meta" + } +} diff --git a/frontend/i18n/fr/docusaurus-plugin-content-docs/current.json b/frontend/i18n/fr/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..0a862b5b136 --- /dev/null +++ b/frontend/i18n/fr/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "Scripting" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "Fonctions de rappel" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "Fonctions" + }, + "sidebar.docsSidebar.category.Language": { + "message": "Langage" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "Référence" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "Ressources" + }, + "sidebar.docsSidebar.category.Server": { + "message": "Serveur" + }, + "sidebar.docsSidebar.category.Client": { + "message": "Client" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "Tutoriels" + }, + "sidebar.docsSidebar.category.meta": { + "message": "Méta" + } +} diff --git a/frontend/i18n/fr/docusaurus-plugin-content-docs/current/client/_.md b/frontend/i18n/fr/docusaurus-plugin-content-docs/current/client/_.md deleted file mode 100644 index 2f984c084f1..00000000000 --- a/frontend/i18n/fr/docusaurus-plugin-content-docs/current/client/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Client -sidebar_label: Client -description: Cette catégorie contient des informations sur les fonctionnalités et le support du client SA-MP. ---- - -Cette catégorie contient des informations sur les fonctionnalités et le support du client SA-MP. diff --git a/frontend/i18n/hu/docusaurus-plugin-content-docs/current.json b/frontend/i18n/hu/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..2edc2b2abf8 --- /dev/null +++ b/frontend/i18n/hu/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "Szkriptelés" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "Visszahívások" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "Függvények" + }, + "sidebar.docsSidebar.category.Language": { + "message": "Nyelv" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "Referencia" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "Erőforrások" + }, + "sidebar.docsSidebar.category.Server": { + "message": "Szerver" + }, + "sidebar.docsSidebar.category.Client": { + "message": "Kliens" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "Oktatóanyagok" + }, + "sidebar.docsSidebar.category.meta": { + "message": "Meta" + } +} diff --git a/frontend/i18n/id/docusaurus-plugin-content-docs/current.json b/frontend/i18n/id/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..054fdf2c8a7 --- /dev/null +++ b/frontend/i18n/id/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "Skrip" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "Callback" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "Fungsi" + }, + "sidebar.docsSidebar.category.Language": { + "message": "Bahasa" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "Referensi" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "Sumber Daya" + }, + "sidebar.docsSidebar.category.Server": { + "message": "Server" + }, + "sidebar.docsSidebar.category.Client": { + "message": "Klien" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "Tutorial" + }, + "sidebar.docsSidebar.category.meta": { + "message": "Meta" + } +} diff --git a/frontend/i18n/id/docusaurus-plugin-content-docs/current/client/_.md b/frontend/i18n/id/docusaurus-plugin-content-docs/current/client/_.md deleted file mode 100644 index 9813b70d296..00000000000 --- a/frontend/i18n/id/docusaurus-plugin-content-docs/current/client/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Client -sidebar_label: Client -description: Kategori ini berisi informasi mengenai fitur client SA-MP beserta dukungannya. ---- - -Kategori ini berisi informasi mengenai fitur client SA-MP beserta dukungannya. diff --git a/frontend/i18n/id/docusaurus-plugin-content-docs/current/tutorials/_.md b/frontend/i18n/id/docusaurus-plugin-content-docs/current/tutorials/_.md deleted file mode 100644 index cffb2b2caea..00000000000 --- a/frontend/i18n/id/docusaurus-plugin-content-docs/current/tutorials/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Tutorial -sidebar_label: Tutorial -description: Sebuah koleksi tutorial untuk membantu kalian dalam menulis gamemode dan mengatur server kalian. ---- - -Pada sesi ini, kalian akan menemukan koleksi tutorial untuk membantu kalian dalam menulis gamemode dan mengatur server kalian. Tutorial ini tidak dalam urutan tertentu. diff --git a/frontend/i18n/it/docusaurus-plugin-content-docs/current.json b/frontend/i18n/it/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..02a926c9ece --- /dev/null +++ b/frontend/i18n/it/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "Scripting" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "Callback" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "Funzioni" + }, + "sidebar.docsSidebar.category.Language": { + "message": "Linguaggio" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "Riferimento" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "Risorse" + }, + "sidebar.docsSidebar.category.Server": { + "message": "Server" + }, + "sidebar.docsSidebar.category.Client": { + "message": "Client" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "Tutorial" + }, + "sidebar.docsSidebar.category.meta": { + "message": "Meta" + } +} diff --git a/frontend/i18n/nl/docusaurus-plugin-content-docs/current.json b/frontend/i18n/nl/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..8ecaaf36e0d --- /dev/null +++ b/frontend/i18n/nl/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "Scripting" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "Callbacks" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "Functies" + }, + "sidebar.docsSidebar.category.Language": { + "message": "Taal" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "Referentie" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "Bronnen" + }, + "sidebar.docsSidebar.category.Server": { + "message": "Server" + }, + "sidebar.docsSidebar.category.Client": { + "message": "Client" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "Tutorials" + }, + "sidebar.docsSidebar.category.meta": { + "message": "Meta" + } +} diff --git a/frontend/i18n/nl/docusaurus-plugin-content-docs/current/client/_.md b/frontend/i18n/nl/docusaurus-plugin-content-docs/current/client/_.md deleted file mode 100644 index 847d0d77649..00000000000 --- a/frontend/i18n/nl/docusaurus-plugin-content-docs/current/client/_.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Client -sidebar_label: Client -description: Deze categorie bevat informatie over SA-MP-clientfuncties en -ondersteuning. ---- - -Deze categorie bevat informatie over SA-MP-clientfuncties en -ondersteuning. - diff --git a/frontend/i18n/nl/docusaurus-plugin-content-docs/current/tutorials/_.md b/frontend/i18n/nl/docusaurus-plugin-content-docs/current/tutorials/_.md deleted file mode 100644 index 28ce7395852..00000000000 --- a/frontend/i18n/nl/docusaurus-plugin-content-docs/current/tutorials/_.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Tutorials -sidebar_label: Tutorials -description: Een verzameling tutorials om gamemodes te schrijven en je server te beheren. ---- - -In deze sectie vind je tutorials die helpen bij het schrijven van gamemodes en het beheren van je server. De volgorde is willekeurig. - - diff --git a/frontend/i18n/pl/docusaurus-plugin-content-docs/current.json b/frontend/i18n/pl/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..b2ed75d6753 --- /dev/null +++ b/frontend/i18n/pl/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "Skrypty" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "Funkcje zwrotne" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "Funkcje" + }, + "sidebar.docsSidebar.category.Language": { + "message": "Język" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "Dokumentacja" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "Zasoby" + }, + "sidebar.docsSidebar.category.Server": { + "message": "Serwer" + }, + "sidebar.docsSidebar.category.Client": { + "message": "Klient" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "Samouczki" + }, + "sidebar.docsSidebar.category.meta": { + "message": "Meta" + } +} diff --git a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current.json b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..5dd20e2174a --- /dev/null +++ b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "Scripting" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "Callbacks" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "Funções" + }, + "sidebar.docsSidebar.category.Language": { + "message": "Linguagem" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "Referência" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "Recursos" + }, + "sidebar.docsSidebar.category.Server": { + "message": "Servidor" + }, + "sidebar.docsSidebar.category.Client": { + "message": "Cliente" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "Tutoriais" + }, + "sidebar.docsSidebar.category.meta": { + "message": "Meta" + } +} diff --git a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/client/_.md b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/client/_.md deleted file mode 100644 index 7336b01e4b7..00000000000 --- a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/client/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Cliente -sidebar_label: Cliente -description: Essa categoria contém informações sobre o cliente do SA-MP, incluindo funções e suporte. ---- - -Essa categoria contém informações sobre o cliente do SA-MP, incluindo funções e suporte. diff --git a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/tutorials/_.md b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/tutorials/_.md deleted file mode 100644 index d22d4b13a7e..00000000000 --- a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/tutorials/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Tutoriais -sidebar_label: Tutoriais -description: Uma coleção de tutoriais para ajudá-lo a escrever gamemodes e gerenciar seu servidor. ---- - -Nesta seção, você encontrará uma coleção de tutoriais para ajudá-lo a escrever gamemodes e gerenciar seu servidor. Eles não estão em nenhuma ordem particular. diff --git a/frontend/i18n/ro/docusaurus-plugin-content-docs/current.json b/frontend/i18n/ro/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..05e9d0f49e3 --- /dev/null +++ b/frontend/i18n/ro/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "Scriptare" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "Callback-uri" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "Funcții" + }, + "sidebar.docsSidebar.category.Language": { + "message": "Limbaj" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "Referință" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "Resurse" + }, + "sidebar.docsSidebar.category.Server": { + "message": "Server" + }, + "sidebar.docsSidebar.category.Client": { + "message": "Client" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "Tutoriale" + }, + "sidebar.docsSidebar.category.meta": { + "message": "Meta" + } +} diff --git a/frontend/i18n/ro/docusaurus-plugin-content-docs/current/tutorials/_.md b/frontend/i18n/ro/docusaurus-plugin-content-docs/current/tutorials/_.md deleted file mode 100644 index 9d849f5ea9d..00000000000 --- a/frontend/i18n/ro/docusaurus-plugin-content-docs/current/tutorials/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Tutoriale -sidebar_label: Tutoriale -description: O colectie de tutoriale pentru a te ajuta la crearea gamemode-ului. ---- - -În această secțiune, veți găsi o colecție de tutoriale pentru a vă ajuta să scrieți moduri de joc și să vă gestionați serverul. Ele nu au o ordine specială. diff --git a/frontend/i18n/ru/docusaurus-plugin-content-docs/current.json b/frontend/i18n/ru/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..095fe3ca42f --- /dev/null +++ b/frontend/i18n/ru/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "Скриптинг" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "Обратные вызовы" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "Функции" + }, + "sidebar.docsSidebar.category.Language": { + "message": "Язык" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "Справочник" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "Ресурсы" + }, + "sidebar.docsSidebar.category.Server": { + "message": "Сервер" + }, + "sidebar.docsSidebar.category.Client": { + "message": "Клиент" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "Руководства" + }, + "sidebar.docsSidebar.category.meta": { + "message": "Мета" + } +} diff --git a/frontend/i18n/ru/docusaurus-plugin-content-docs/current/client/_.md b/frontend/i18n/ru/docusaurus-plugin-content-docs/current/client/_.md deleted file mode 100644 index 31c5a28ec1b..00000000000 --- a/frontend/i18n/ru/docusaurus-plugin-content-docs/current/client/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Клиент -sidebar_label: Клиент -description: Эта категория содержит информацию о функциях и поддержке клиента SA-MP. ---- - -Эта категория содержит информацию о функциях и поддержке клиента SA-MP. diff --git a/frontend/i18n/ru/docusaurus-plugin-content-docs/current/tutorials/_.md b/frontend/i18n/ru/docusaurus-plugin-content-docs/current/tutorials/_.md deleted file mode 100644 index b597d47407f..00000000000 --- a/frontend/i18n/ru/docusaurus-plugin-content-docs/current/tutorials/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Туториалы -sidebar_label: Туториалы -description: Сборник туториалов, помогающих в написании игровых режимов (модов) и управлении вашим сервером. ---- - -В этой секции вы найдёте различные туториалы, помогающие в написании игровых режимов (модов) и управлении вашим сервером. Никакого упорядочивания не предусмотрено. diff --git a/frontend/i18n/sl/docusaurus-plugin-content-docs/current.json b/frontend/i18n/sl/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..637df9bd5a5 --- /dev/null +++ b/frontend/i18n/sl/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "Ustvarjanje skript" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "Povratne funkcije" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "Funkcije" + }, + "sidebar.docsSidebar.category.Language": { + "message": "Jezik" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "Referenca" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "Viri" + }, + "sidebar.docsSidebar.category.Server": { + "message": "Strežnik" + }, + "sidebar.docsSidebar.category.Client": { + "message": "Odjemalec" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "Vodiči" + }, + "sidebar.docsSidebar.category.meta": { + "message": "Meta" + } +} diff --git a/frontend/i18n/sr/docusaurus-plugin-content-docs/current.json b/frontend/i18n/sr/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..4fac5d1c6b2 --- /dev/null +++ b/frontend/i18n/sr/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "Скриптирање" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "Повратни позиви" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "Функције" + }, + "sidebar.docsSidebar.category.Language": { + "message": "Језик" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "Референца" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "Ресурси" + }, + "sidebar.docsSidebar.category.Server": { + "message": "Сервер" + }, + "sidebar.docsSidebar.category.Client": { + "message": "Клијент" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "Туторијали" + }, + "sidebar.docsSidebar.category.meta": { + "message": "Мета" + } +} diff --git a/frontend/i18n/sr/docusaurus-plugin-content-docs/current/client/_.md b/frontend/i18n/sr/docusaurus-plugin-content-docs/current/client/_.md deleted file mode 100644 index 6ec31791632..00000000000 --- a/frontend/i18n/sr/docusaurus-plugin-content-docs/current/client/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Клијент -sidebar_label: Клијент -description: Ова категорија садржи информације о карактеристикама и подршци SA-MP клијента. ---- - -Ова категорија садржи информације о карактеристикама и подршци SA-MP клијента. diff --git a/frontend/i18n/ta/docusaurus-plugin-content-docs/current.json b/frontend/i18n/ta/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..c12ca446364 --- /dev/null +++ b/frontend/i18n/ta/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "ஸ்கிரிப்டிங்" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "கால்பேக்குகள்" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "செயல்பாடுகள்" + }, + "sidebar.docsSidebar.category.Language": { + "message": "மொழி" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "குறிப்பு" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "வளங்கள்" + }, + "sidebar.docsSidebar.category.Server": { + "message": "சர்வர்" + }, + "sidebar.docsSidebar.category.Client": { + "message": "கிளையன்" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "பயிற்சிகள்" + }, + "sidebar.docsSidebar.category.meta": { + "message": "மெட்டா" + } +} diff --git a/frontend/i18n/ta/docusaurus-plugin-content-docs/current/client/_.md b/frontend/i18n/ta/docusaurus-plugin-content-docs/current/client/_.md deleted file mode 100644 index 6ca17926eeb..00000000000 --- a/frontend/i18n/ta/docusaurus-plugin-content-docs/current/client/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Client -sidebar_label: Client -description: இந்த வகை SA-MP கிளையன்ட் அம்சங்கள் மற்றும் ஆதரவு பற்றிய தகவல்களைக் கொண்டுள்ளது. ---- - -இந்த வகை SA-MP கிளையன்ட் அம்சங்கள் மற்றும் ஆதரவு பற்றிய தகவல்களைக் கொண்டுள்ளது. diff --git a/frontend/i18n/th/docusaurus-plugin-content-docs/current.json b/frontend/i18n/th/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..52f4f941525 --- /dev/null +++ b/frontend/i18n/th/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "การเขียนสคริปต์" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "การเรียกกลับ" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "ฟังก์ชัน" + }, + "sidebar.docsSidebar.category.Language": { + "message": "ภาษา" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "ข้อมูลอ้างอิง" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "ทรัพยากร" + }, + "sidebar.docsSidebar.category.Server": { + "message": "เซิร์ฟเวอร์" + }, + "sidebar.docsSidebar.category.Client": { + "message": "ไคลเอ็นต์" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "บทแนะนำ" + }, + "sidebar.docsSidebar.category.meta": { + "message": "เมตา" + } +} diff --git a/frontend/i18n/th/docusaurus-plugin-content-docs/current/tutorials/_.md b/frontend/i18n/th/docusaurus-plugin-content-docs/current/tutorials/_.md deleted file mode 100644 index 7c26dc672e8..00000000000 --- a/frontend/i18n/th/docusaurus-plugin-content-docs/current/tutorials/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: การสอน -sidebar_label: การสอน -description: ชุดแบบฝึกหัดที่จะช่วยคุณในการเขียนเกมโหมดและจัดการเซิร์ฟเวอร์ของคุณ ---- - -ในส่วนนี้คุณจะพบกับชุดแบบฝึกหัดที่จะช่วยคุณในการเขียนเกมโหมดและจัดการเซิร์ฟเวอร์ของคุณ แบบฝึกหัดนี้ไม่มีลำดับเฉพาะ diff --git a/frontend/i18n/tr/docusaurus-plugin-content-docs/current.json b/frontend/i18n/tr/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..2dee39d2b81 --- /dev/null +++ b/frontend/i18n/tr/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "Betik Yazma" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "Geri Çağrılar" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "Fonksiyonlar" + }, + "sidebar.docsSidebar.category.Language": { + "message": "Dil" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "Referans" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "Kaynaklar" + }, + "sidebar.docsSidebar.category.Server": { + "message": "Sunucu" + }, + "sidebar.docsSidebar.category.Client": { + "message": "İstemci" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "Eğitimler" + }, + "sidebar.docsSidebar.category.meta": { + "message": "Meta" + } +} diff --git a/frontend/i18n/tr/docusaurus-plugin-content-docs/current/client/_.md b/frontend/i18n/tr/docusaurus-plugin-content-docs/current/client/_.md deleted file mode 100644 index 8dd1732ebe0..00000000000 --- a/frontend/i18n/tr/docusaurus-plugin-content-docs/current/client/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: İstemci -sidebar_label: İstemci -description: Bu kategori, SA-MP istemci özellikleri ve destek konularına dair bilgiler içermektedir. ---- - -Bu kategori, SA-MP istemci özellikleri ve destek konularına dair bilgiler içermektedir. diff --git a/frontend/i18n/tr/docusaurus-plugin-content-docs/current/tutorials/_.md b/frontend/i18n/tr/docusaurus-plugin-content-docs/current/tutorials/_.md deleted file mode 100644 index ef8fdae1532..00000000000 --- a/frontend/i18n/tr/docusaurus-plugin-content-docs/current/tutorials/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Tutorials -sidebar_label: Tutorials -description: A collection of tutorials to help you write gamemodes and manage your server. ---- - -In this section, you'll find a collection of tutorials to help you write gamemodes and manage your server. They are in no particular order. diff --git a/frontend/i18n/vi/docusaurus-plugin-content-docs/current.json b/frontend/i18n/vi/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..66476cd054b --- /dev/null +++ b/frontend/i18n/vi/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "Lập trình kịch bản" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "Hàm gọi lại" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "Hàm" + }, + "sidebar.docsSidebar.category.Language": { + "message": "Ngôn ngữ" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "Tham khảo" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "Tài nguyên" + }, + "sidebar.docsSidebar.category.Server": { + "message": "Máy chủ" + }, + "sidebar.docsSidebar.category.Client": { + "message": "Máy khách" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "Hướng dẫn" + }, + "sidebar.docsSidebar.category.meta": { + "message": "Meta" + } +} diff --git a/frontend/i18n/vi/docusaurus-plugin-content-docs/current/client/_.md b/frontend/i18n/vi/docusaurus-plugin-content-docs/current/client/_.md deleted file mode 100644 index 547798b7608..00000000000 --- a/frontend/i18n/vi/docusaurus-plugin-content-docs/current/client/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Client -sidebar_label: Client -description: Trang này chứa thông tin về các tính năng và những gì SA-MP Client hỗ trợ. ---- - -Trang này chứa thông tin về các tính năng và những gì SA-MP Client hỗ trợ. diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current.json b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..41e4ff6e803 --- /dev/null +++ b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "脚本编写" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "回调" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "函数" + }, + "sidebar.docsSidebar.category.Language": { + "message": "语言" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "参考文献" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "资源" + }, + "sidebar.docsSidebar.category.Server": { + "message": "服务器" + }, + "sidebar.docsSidebar.category.Client": { + "message": "客户端" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "教程" + }, + "sidebar.docsSidebar.category.meta": { + "message": "元数据" + } +} diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/client/_.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/client/_.md deleted file mode 100644 index 76324690ab4..00000000000 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/client/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: 客户端 -sidebar_label: 客户端 -description: 本类别包含有关SA-MP客户端功能及支持的信息。 ---- - -本类别包含有关SA-MP客户端功能及支持的信息。 diff --git a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/_.md b/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/_.md deleted file mode 100644 index b3583e1b5d4..00000000000 --- a/frontend/i18n/zh-CN/docusaurus-plugin-content-docs/current/tutorials/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: 教程 -sidebar_label: 教程 -description: 收录各类教程，助你编写游戏模式并管理服务器。 ---- - -本节内容汇集了多篇教程指南，助你掌握游戏模式开发与服务器管理技巧。教程排列不分先后顺序，请根据需求查阅。 diff --git a/frontend/i18n/zh-TW/docusaurus-plugin-content-docs/current.json b/frontend/i18n/zh-TW/docusaurus-plugin-content-docs/current.json new file mode 100644 index 00000000000..560071bc987 --- /dev/null +++ b/frontend/i18n/zh-TW/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,32 @@ +{ + "sidebar.docsSidebar.category.Scripting": { + "message": "腳本編寫" + }, + "sidebar.docsSidebar.category.Callbacks": { + "message": "回呼" + }, + "sidebar.docsSidebar.category.Functions": { + "message": "函數" + }, + "sidebar.docsSidebar.category.Language": { + "message": "語言" + }, + "sidebar.docsSidebar.category.Reference": { + "message": "參考文獻" + }, + "sidebar.docsSidebar.category.Resources": { + "message": "資源" + }, + "sidebar.docsSidebar.category.Server": { + "message": "伺服器" + }, + "sidebar.docsSidebar.category.Client": { + "message": "客戶端" + }, + "sidebar.docsSidebar.category.Tutorials": { + "message": "教學" + }, + "sidebar.docsSidebar.category.meta": { + "message": "後設資料" + } +} diff --git a/frontend/i18n/zh-TW/docusaurus-plugin-content-docs/current/client/_.md b/frontend/i18n/zh-TW/docusaurus-plugin-content-docs/current/client/_.md deleted file mode 100644 index 0c9088c3032..00000000000 --- a/frontend/i18n/zh-TW/docusaurus-plugin-content-docs/current/client/_.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: 用戶端 -sidebar_label: 用戶端 -description: 此分類包含 SA-MP 用戶端功能和支援相關的資訊。 ---- - -此分類包含 SA-MP 用戶端功能和支援相關的資訊。 From 35ef021f77953391fc627c943f1e2baf7b03daf8 Mon Sep 17 00:00:00 2001 From: dockfries Date: Fri, 13 Mar 2026 22:07:26 +0800 Subject: [PATCH 04/24] fix missing ':' tips --- .../current/scripting/functions/SetPlayerPos.md | 2 +- .../current/scripting/functions/SetPlayerSkin.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPos.md b/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPos.md index 58a2b274e72..2fad395f000 100644 --- a/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPos.md +++ b/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerPos.md @@ -39,7 +39,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) ## نکته‌ها -::tip +:::tip - اگر بازیکن در خودرو باشد، از [RemovePlayerFromVehicle](RemovePlayerFromVehicle) قبل از SetPlayerPos استفاده کنید. diff --git a/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerSkin.md b/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerSkin.md index 6a3bd573955..2d4ce343e4a 100644 --- a/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerSkin.md +++ b/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/functions/SetPlayerSkin.md @@ -37,7 +37,7 @@ public OnPlayerCommandText(playerid, cmdtext[]) ## نکته‌ها -::tip +:::tip - از [SpawnPlayer](SpawnPlayer) پس از تغییر اسکین استفاده کردن برای اعمال تغییرات توصیه می‌شود. - برخی اسکین‌ها معتبر نیستند. در صورت استفاده از اسکین نامعتبر، بازی ممکن است کرش کند. From b076c3d0b0dd064f3a50247befd5a51956e71d5a Mon Sep 17 00:00:00 2001 From: dockfries Date: Tue, 17 Mar 2026 17:35:43 +0800 Subject: [PATCH 05/24] fix table formatting in Operators-and-expressions --- .../reference/07-Operators-and-expressions.md | 215 ++++++------ .../reference/07-Operators-and-expressions.md | 331 +++++++++--------- 2 files changed, 272 insertions(+), 274 deletions(-) diff --git a/frontend/docs/scripting/language/reference/07-Operators-and-expressions.md b/frontend/docs/scripting/language/reference/07-Operators-and-expressions.md index 7c68e70d84d..a812b636e46 100644 --- a/frontend/docs/scripting/language/reference/07-Operators-and-expressions.md +++ b/frontend/docs/scripting/language/reference/07-Operators-and-expressions.md @@ -40,7 +40,7 @@ v = (ia1 * ia2) / ia3 | - | e1 - e2 | | | Results in sthe subtraction of e1 and e2 | | | -e | -| | Results in the arithmetic negation of a (two’s complement). | +| | Results in the arithmetic negation of a (two's complement). | | \* | e1 \* e2 | | | Results in the multiplication of e1 and e2. | | / | e1 / e2 | @@ -61,31 +61,31 @@ v = (ia1 * ia2) / ia3 ### • Bit manipulation | Sign | Description | -| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | --- | +| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ~ | ~e | -| | results in the one’s complement of e. | +| | results in the one's complement of e. | | >> | e1 >> e2 | | | results in the arithmetic shift to the right of e1 by e2 bits. The shift operation is signed: the leftmost bit of e1 is copied to vacant bits in the result. | | >>> | e1 >>> e2 | | | results in the logical shift to the right of e1 by e2 bits. The shift operation is unsigned: the vacant bits of the result are filled with zeros. | -| \<\< | e1 \<\< e2 | +| `<<` | `e1 << e2` | | | results in the value of e1 shifted to the left by e2 bits; the rightmost bits are set to zero. There is no distinction between an arithmetic and a logical left shift | -| & | eq & e2 | -| | results in the bitwise logical “and” of e1 and e2. | -| | | e1 | e2 | -| | results in the bitwise logical “or” of e1 and e2. | +| & | e1 & e2 | +| | results in the bitwise logical "and" of e1 and e2. | +| \| | e1 \| e2 | +| | results in the bitwise logical "or" of e1 and e2. | | ^ | e1 ^ e2 | -| | results in the bitwise “exclusive or” of e1 and e2. | +| | results in the bitwise "exclusive or" of e1 and e2. | ### • Assignment The result of an assignment expression is the value of the left operand after the assignment. The left operand may not be tagged. | Sign | Description | -| ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | --- | +| ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | = | v = e | | | assigns the value of e to variable v. | -| | If “v” is an array, it must have an explicit size and “e” must be an array of the same size; “e” may be a string or a literal array. | +| | If "v" is an array, it must have an explicit size and "e" must be an array of the same size; "e" may be a string or a literal array. | | Note | the following operators combine an assignment with an arithmetic or a bitwise operation; the result of the expression is the value of the left operand after the arithmetic or bitwise operation. | | += | v += e | | | increments v with a. | @@ -101,80 +101,79 @@ The result of an assignment expression is the value of the left operand after th | | shifts v arithmetically to the right by e bits. | | >>>= | v >>>= e | | | shifts v logically to the right by e bits. | -| \<\<= | v \<\<= e | +| `<<=` | `v <<= e` | | | shifts v to the left by e bits. | | &= | v &= e | -| | applies a bitwise “and” to v and e and assigns the result to v. | -| | = | v | = e | -| | applies a bitwise “or” to v and e and assigns the result to v. | +| | applies a bitwise "and" to v and e and assigns the result to v. | +| \|= | v \|= e | +| | applies a bitwise "or" to v and e and assigns the result to v. | | ^= | v ^= e | -| | applies a bitwise “exclusive or” to v and e and assigns the | -| | result to v. | +| | applies a bitwise "exclusive or" to v and e and assigns the result to v. | ### • Relational -A logical “false” is represented by an integer value of 0; a logical “true” is represented by any value other than 0. Value results of relational expressions are either 0 or 1, and their tag is set to “bool:”. - -| Sign | Description | -| ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| == | e1 == e2 | -| | results in a logical “true” if e1 is equal to e2. | -| != | e1 != e2 | -| | results in a logical “true” if e1 differs from e2. | -| Note: | the following operators may be “chained”, as in the expression “e1 \<= e2 \<= e3”, with the semantics that the result is “1” if all individual comparisons hold and “0” otherwise. | -| \< | e1 < e2 | -| | results in a logical “true” if e1 is smaller than e2. | -| \<= | e1 \<= e2 | -| | results in a logical “true” if e1 is smaller than or equal to e2. | -| > | e1 > e2 | -| | results in a logical “true” if e1 is greater than e2. | -| >= | e1 >= e2 | -| | results in a logical “true” if e1 is greater than or equal to e2. | +A logical "false" is represented by an integer value of 0; a logical "true" is represented by any value other than 0. Value results of relational expressions are either 0 or 1, and their tag is set to "bool:". + +| Sign | Description | +| ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| == | e1 == e2 | +| | results in a logical "true" if e1 is equal to e2. | +| != | e1 != e2 | +| | results in a logical "true" if e1 differs from e2. | +| Note: | the following operators may be "chained", as in the expression `e1 <= e2 <= e3`, with the semantics that the result is "1" if all individual comparisons hold and "0" otherwise. | +| `<` | `e1 < e2` | +| | results in a logical "true" if e1 is smaller than e2. | +| `<=` | `e1 <= e2` | +| | results in a logical "true" if e1 is smaller than or equal to e2. | +| > | e1 > e2 | +| | results in a logical "true" if e1 is greater than e2. | +| >= | e1 >= e2 | +| | results in a logical "true" if e1 is greater than or equal to e2. | ### • Boolean -A logical “false” is represented by an integer value of 0; a logical “true” is represented by any value other than 0. Value results of Boolean expressions are either 0 or 1, and their tag is set to “bool”. +A logical "false" is represented by an integer value of 0; a logical "true" is represented by any value other than 0. Value results of Boolean expressions are either 0 or 1, and their tag is set to "bool". | Sign | Description | -| ---- | ---------------------------------------------------------------------------------------------------------------------------------------------- | --- | --- | --- | --- | +| ---- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | ! | !e | -| | results to a logical “true” if e was logically “false”. | -| | | | e1 | | e2 | -| | results to a logical “true” if either e1 or e2 (or both) are logically “true”. The expression e2 is only evaluated if e1 is logically “false”. | +| | results to a logical "true" if e was logically "false". | +| \|\| | e1 \|\| e2 | +| | results to a logical "true" if either e1 or e2 (or both) are logically "true". The expression e2 is only evaluated if e1 is logically "false". | | && | e1 && e2 | -| | results to a logical “true” if both e1 and e2 are logically “true”. | -| | The expression e2 is only evaluated if e1 is logically “true”. | +| | results to a logical "true" if both e1 and e2 are logically "true". | +| | The expression e2 is only evaluated if e1 is logically "true". | ### • Miscellaneous -| Sign | Description | -| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [] | a\[e\] | -| | array index: results to cell e from array a. | -| \{\} | a\{e\} | -| | array index: results to character e from “packed” array a. | -| () | f(e1,e2,...eN) | -| | results to the value returned by the function f. The function is called with the arguments e1, e2, . . . eN. The order of evaluation of the arguments is undefined (an implementation may choose to evaluate function arguments in reversed order). | -| ? : | e1 ? e2 : e3 | -| | results in either e2 or e3, depending on the value of e1. The conditional expression is a compound expression with a two part operator, “?” and “:”. Expression e2 is evaluated if e1 is logically “true”, e3 is evaluated if e1 is logically “false”. | -| : | tagname: e | -| | tag override; the value of the expression e does not change, but its tag changes. See page 68 for more information. | -| , | e1, e2 | -| | results in e2, e1 is evaluated before e2. If used in function argument lists or a conditional expression, the comma expression must be surrounded by parentheses. | -| defined | defined s | -| | results in the value 1 if the symbol is defined. The symbol may be a constant (page 98), or a global or local variable. | -| | The tag of this expression is bool:. | -| sizeof | sizeof s | -| | results in the size in “elements” of the specified variable. For simple variables and for arrays with a single dimension, an element is a cell. For multi-dimensional arrays, the result is the number of array elements in that dimension —append [] to the array name to indicate a lower/more minor dimension. If the size of a variable is unknown, the result is zero. | -| | When used in a default value for a function argument, the expression is evaluation at the point of the function call, instead of in the function definition. | -| state | state s | -| | where “s” is the name of a state that is optionally prefixed with the automaton name, this operator results in the value 1 if the automatons is in the indicated state and in 0 otherwise. | -| | The tag of this expression is bool:. | -| tagof | tagof s | -| | results in the a unique number that represents the tag of the variable, the constant, the function result or the tag label. | -| | When used in a default value for a function argument, the expression is evaluation at the point of the function call, instead of in the function definition. | -| char | e char | -| | results the number of cells that are needed to hold a packed array of e characters. | +| Sign | Description | +| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| [] | a[e] | +| | array index: results to cell e from array a. | +| {} | a{e} | +| | array index: results to character e from "packed" array a. | +| () | f(e1,e2,...eN) | +| | results to the value returned by the function f. The function is called with the arguments e1, e2, . . . eN. The order of evaluation of the arguments is undefined. | +| ? : | e1 ? e2 : e3 | +| | results in either e2 or e3, depending on the value of e1. The conditional expression is a compound expression with a two part operator, "?" and ":". Expression e2 is evaluated if e1 is logically "true", e3 is evaluated if e1 is logically "false". | +| : | tagname: e | +| | tag override; the value of the expression e does not change, but its tag changes. See page 68 for more information. | +| , | e1, e2 | +| | results in e2, e1 is evaluated before e2. If used in function argument lists or a conditional expression, the comma expression must be surrounded by parentheses. | +| defined | defined s | +| | results in the value 1 if the symbol is defined. The symbol may be a constant (page 98), or a global or local variable. | +| | The tag of this expression is bool:. | +| sizeof | sizeof s | +| | results in the size in "elements" of the specified variable. For simple variables and for arrays with a single dimension, an element is a cell. | +| | When used in a default value for a function argument, the expression is evaluation at the point of the function call, instead of in the function definition. | +| state | state s | +| | where "s" is the name of a state that is optionally prefixed with the automaton name, this operator results in the value 1 if the automatons is in the indicated state and in 0 otherwise. | +| | The tag of this expression is bool:. | +| tagof | tagof s | +| | results in the a unique number that represents the tag of the variable, the constant, the function result or the tag label. | +| | When used in a default value for a function argument, the expression is evaluation at the point of the function call, instead of in the function definition. | +| char | e char | +| | results the number of cells that are needed to hold a packed array of e characters. | ### • Operator precedence @@ -185,45 +184,45 @@ If the expression evaluation order is not explicitly established by parentheses, it is determined by the association rules. For example: a*b/c is equivalent with (a*b)/c because of the left-to-right association, and a=b=c is equivalent with a=(b=c). -| Sign | Description | | -| ------------------------------------ | -------------------------------------------- | ------------- | ------------- | ------------- | -| () | function call | left-to-right | -| [] | array index (cell) | | -| {} | array index (character) | | -| ! | logical not | right-to-left | -| ~ | one's complement | | -| - | two's complement | | -| ++ | increment | | -| -- | decrement | | -| : | tag override | | -| char | convert number of packed characters to cells | | -| defined | symbol definition status | | -| sizeof | symbol size in "elements" | | -| state | automaton/state condition | | -| tagof | unique number for the tag | | -| \* | multiplication | left-to-right | -| / | division | | -| % | modulus | | -| + | addition | left-to-right | -| - | subtraction | | -| >> | shift right | left-to-right | -| >>> | logical shift right | | -| \<\< | shift left | | -| & | bitwise and | left-to-right | -| ^ | bitwise exclusive or | left-to-right | -| | | bitwise or | left-to-right | -| \< | smaller than | left-to-right | -| \<= | smaller than or eaqual to | | -| > | greater than | | -| >= | greater than or eaqual to | | -| == | equality | left-to-right | -| != | inequality | | -| && | logical and | left-to-right | -| | | | logical or | left-to-right | -| ? : | conditional | right-to-left | -| = | assignment | right-to-left | -| \*= /= %= += -= >>= >>>= \<\<= &= ^= | = | | | -| , | comma | left-to-right | +| Sign | Description | Associativity | +| ---------------------------------------- | -------------------------------------------- | ------------- | +| () | function call | left-to-right | +| [] | array index (cell) | left-to-right | +| {} | array index (character) | left-to-right | +| ! | logical not | right-to-left | +| ~ | one's complement | right-to-left | +| - | two's complement | right-to-left | +| ++ | increment | right-to-left | +| -- | decrement | right-to-left | +| : | tag override | right-to-left | +| char | convert number of packed characters to cells | right-to-left | +| defined | symbol definition status | right-to-left | +| sizeof | symbol size in "elements" | right-to-left | +| state | automaton/state condition | right-to-left | +| tagof | unique number for the tag | right-to-left | +| \* | multiplication | left-to-right | +| / | division | left-to-right | +| % | modulus | left-to-right | +| + | addition | left-to-right | +| - | subtraction | left-to-right | +| >> | shift right | left-to-right | +| >>> | logical shift right | left-to-right | +| `<<` | shift left | left-to-right | +| & | bitwise and | left-to-right | +| ^ | bitwise exclusive or | left-to-right | +| \| | bitwise or | left-to-right | +| `<` | smaller than | left-to-right | +| `<=` | smaller than or equal to | left-to-right | +| > | greater than | left-to-right | +| >= | greater than or equal to | left-to-right | +| == | equality | left-to-right | +| != | inequality | left-to-right | +| && | logical and | left-to-right | +| \|\| | logical or | left-to-right | +| ? : | conditional | right-to-left | +| = | assignment | right-to-left | +| `\*= /= %= += -= >>= >>>= <<= &= ^= \|=` | combined operators | right-to-left | +| , | comma | left-to-right | --- diff --git a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/07-Operators-and-expressions.md b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/07-Operators-and-expressions.md index b91e74e6f94..31e09ab0c0d 100644 --- a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/07-Operators-and-expressions.md +++ b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/07-Operators-and-expressions.md @@ -7,13 +7,13 @@ A operação de alguns operadores depende dos tipos específicos de operandos. Portanto, os operandos são notados assim: -| Operadores | Uso | -| ---------- | ---------------------------------------------------------------------------------- | -| e | qualquer expressão; | -| v | qualquer expressão à qual um valor pode ser atribuído (expressões "lvalue"); | -| a | um array; | -| f | uma função; | -| s | um símbolo — que é uma variável, uma constante ou uma função. | +| Operadores | Uso | +| ---------- | ---------------------------------------------------------------------------- | +| e | qualquer expressão; | +| v | qualquer expressão à qual um valor pode ser atribuído (expressões "lvalue"); | +| a | um array; | +| f | uma função; | +| s | um símbolo — que é uma variável, uma constante ou uma função. | ### • Expressões @@ -33,148 +33,147 @@ v = (ia1 * ia2) / ia3 ### • Aritmética -| Sinal | Descrição | -| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| + | e1 + e2 | -| | Resulta na adição de e1 e e2 | -| - | e1 - e2 | -| | Resulta na subtração de e1 e e2 | -| | -e | -| | Resulta na negação aritmética de a (complemento de dois). | -| \* | e1 \* e2 | -| | Resulta na multiplicação de e1 e e2. | -| / | e1 / e2 | +| Sinal | Descrição | +| ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| + | e1 + e2 | +| | Resulta na adição de e1 e e2 | +| - | e1 - e2 | +| | Resulta na subtração de e1 e e2 | +| | -e | +| | Resulta na negação aritmética de a (complemento de dois). | +| \* | e1 \* e2 | +| | Resulta na multiplicação de e1 e e2. | +| / | e1 / e2 | | | Resulta na divisão de e1 por e2. O resultado é truncado para o valor integral mais próximo que é menor ou igual ao quociente. Tanto valores negativos quanto positivos são arredondados para baixo, ou seja, em direção a −∞. | -| % | e1 % e2 | -| | Resulta no módulo (resto da divisão) de e1 por e2. O módulo é sempre um valor positivo. | -| ++ | v++ | -| | incrementa v em 1; o resultado da expressão é o valor de v antes de ser incrementado. | -| | ++v | -| | incrementa v em 1; o resultado da expressão é o valor de v depois de ser incrementado. | -| -- | v-- | -| | decrementa v em 1; o resultado da expressão é o valor de v antes de ser decrementado. | -| | --v | -| | decrementa v em 1; o resultado da expressão é o valor de v depois de ser decrementado. | -| Notas: | O + unário não é definido em pawn | -| | Os operadores ++ e -- modificam o operando. O operando deve ser um lvalue. | +| % | e1 % e2 | +| | Resulta no módulo (resto da divisão) de e1 por e2. O módulo é sempre um valor positivo. | +| ++ | v++ | +| | incrementa v em 1; o resultado da expressão é o valor de v antes de ser incrementado. | +| | ++v | +| | incrementa v em 1; o resultado da expressão é o valor de v depois de ser incrementado. | +| -- | v-- | +| | decrementa v em 1; o resultado da expressão é o valor de v antes de ser decrementado. | +| | --v | +| | decrementa v em 1; o resultado da expressão é o valor de v depois de ser decrementado. | +| Notas: | O + unário não é definido em pawn | +| | Os operadores ++ e -- modificam o operando. O operando deve ser um lvalue. | ### • Manipulação de bits -| Sinal | Descrição | -| ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | --- | -| ~ | ~e | -| | resulta no complemento de um de e. | -| >> | e1 >> e2 | -| | resulta no deslocamento aritmético para a direita de e1 por e2 bits. A operação de deslocamento é com sinal: o bit mais à esquerda de e1 é copiado para os bits vagos no resultado. | -| >>> | e1 >>> e2 | -| | resulta no deslocamento lógico para a direita de e1 por e2 bits. A operação de deslocamento é sem sinal: os bits vagos do resultado são preenchidos com zeros. | -| \<\< | e1 \<\< e2 | -| | resulta no valor de e1 deslocado para a esquerda por e2 bits; os bits mais à direita são definidos como zero. Não há distinção entre um deslocamento à esquerda aritmético e um lógico | -| & | e1 & e2 | -| | resulta no "e" lógico bit a bit de e1 e e2. | -| | | e1 | e2 | -| | resulta no "ou" lógico bit a bit de e1 e e2. | -| ^ | e1 ^ e2 | -| | resulta no "ou exclusivo" bit a bit de e1 e e2. | +| Sinal | Descrição | +| ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| ~ | ~e | +| | resulta no complemento de um de e. | +| >> | e1 >> e2 | +| | resulta no deslocamento aritmético para a direita de e1 por e2 bits. A operação de deslocamento é com sinal: o bit mais à esquerda de e1 é copiado para os bits vagos no resultado. | +| >>> | e1 >>> e2 | +| | resulta no deslocamento lógico para a direita de e1 por e2 bits. A operação de deslocamento é sem sinal: os bits vagos do resultado são preenchidos com zeros. | +| `<<` | `e1 << e2` | +| | resulta no valor de e1 deslocado para a esquerda por e2 bits; os bits mais à direita são definidos como zero. Não há distinção entre um deslocamento à esquerda aritmético e um lógico. | +| & | e1 & e2 | +| | resulta no "e" lógico bit a bit de e1 e e2. | +| \| | e1 \| e2 | +| | resulta no "ou" lógico bit a bit de e1 e e2. | +| ^ | e1 ^ e2 | +| | resulta no "ou exclusivo" bit a bit de e1 e e2. | ### • Atribuição O resultado de uma expressão de atribuição é o valor do operando esquerdo após a atribuição. O operando esquerdo não pode ter tag. -| Sinal | Descrição | -| ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | --- | -| = | v = e | -| | atribui o valor de e à variável v. | -| | Se "v" é um array, ele deve ter um tamanho explícito e "e" deve ser um array do mesmo tamanho; "e" pode ser uma string ou um array literal. | -| Nota | os seguintes operadores combinam uma atribuição com uma operação aritmética ou bit a bit; o resultado da expressão é o valor do operando esquerdo após a operação aritmética ou bit a bit. | -| += | v += e | -| | incrementa v com e. | -| -= | v -= e | -| | decrementa v com e | -| \*= | v \*= e | -| | multiplica v por e | -| /= | v /= e | -| | divide v por e. | -| %= | v %= e | -| | atribui o resto da divisão de v por e a v. | -| >>= | v >>= e | -| | desloca v aritmeticamente para a direita por e bits. | -| >>>= | v >>>= e | -| | desloca v logicamente para a direita por e bits. | -| \<\<= | v \<\<= e | -| | desloca v para a esquerda por e bits. | -| &= | v &= e | -| | aplica um "e" bit a bit a v e e e atribui o resultado a v. | -| | = | v | = e | -| | aplica um "ou" bit a bit a v e e e atribui o resultado a v. | -| ^= | v ^= e | -| | aplica um "ou exclusivo" bit a bit a v e e e atribui o | -| | resultado a v. | +| Sinal | Descrição | +| ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| = | v = e | +| | atribui o valor de e à variável v. | +| | Se "v" é um array, ele deve ter um tamanho explícito e "e" deve ser um array do mesmo tamanho; "e" pode ser uma string ou um array literal. | +| Nota | os seguintes operadores combinam uma atribuição com uma operação aritmética ou bit a bit; o resultado da expressão é o valor do operando esquerdo após a operação aritmética ou bit a bit. | +| += | v += e | +| | incrementa v com e. | +| -= | v -= e | +| | decrementa v com e | +| \*= | v \*= e | +| | multiplica v por e | +| /= | v /= e | +| | divide v por e. | +| %= | v %= e | +| | atribui o resto da divisão de v por e a v. | +| >>= | v >>= e | +| | desloca v aritmeticamente para a direita por e bits. | +| >>>= | v >>>= e | +| | desloca v logicamente para a direita por e bits. | +| `<<=` | `v <<= e` | +| | desloca v para a esquerda por e bits. | +| &= | v &= e | +| | aplica um "e" bit a bit a v e e e atribui o resultado a v. | +| \|= | v \|= e | +| | aplica um "ou" bit a bit a v e e e atribui o resultado a v. | +| ^= | v ^= e | +| | aplica um "ou exclusivo" bit a bit a v e e e atribui o resultado a v. | ### • Relacionais Um "falso" lógico é representado por um valor inteiro de 0; um "verdadeiro" lógico é representado por qualquer valor diferente de 0. Os resultados de valor das expressões relacionais são 0 ou 1, e sua tag é definida como "bool:". -| Sinal | Descrição | -| ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| == | e1 == e2 | -| | resulta em "verdadeiro" lógico se e1 é igual a e2. | -| != | e1 != e2 | -| | resulta em "verdadeiro" lógico se e1 é diferente de e2. | -| Nota: | os seguintes operadores podem ser "encadeados", como na expressão "e1 \<= e2 \<= e3", com a semântica de que o resultado é "1" se todas as comparações individuais forem válidas e "0" caso contrário. | -| \< | e1 < e2 | -| | resulta em "verdadeiro" lógico se e1 é menor que e2. | -| \<= | e1 \<= e2 | -| | resulta em "verdadeiro" lógico se e1 é menor ou igual a e2. | -| > | e1 > e2 | -| | resulta em "verdadeiro" lógico se e1 é maior que e2. | -| >= | e1 >= e2 | -| | resulta em "verdadeiro" lógico se e1 é maior ou igual a e2. | +| Sinal | Descrição | +| ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| == | e1 == e2 | +| | resulta em "verdadeiro" lógico se e1 é igual a e2. | +| != | e1 != e2 | +| | resulta em "verdadeiro" lógico se e1 é diferente de e2. | +| Nota: | os seguintes operadores podem ser "encadeados", como na expressão `e1 <= e2 <= e3`, com a semântica de que o resultado é "1" se todas as comparações individuais forem válidas e "0" caso contrário. | +| `<` | `e1 < e2` | +| | resulta em "verdadeiro" lógico se e1 é menor que e2. | +| `<=` | `e1 <= e2` | +| | resulta em "verdadeiro" lógico se e1 é menor ou igual a e2. | +| > | e1 > e2 | +| | resulta em "verdadeiro" lógico se e1 é maior que e2. | +| >= | e1 >= e2 | +| | resulta em "verdadeiro" lógico se e1 é maior ou igual a e2. | ### • Booleanos Um "falso" lógico é representado por um valor inteiro de 0; um "verdadeiro" lógico é representado por qualquer valor diferente de 0. Os resultados de valor das expressões booleanas são 0 ou 1, e sua tag é definida como "bool". -| Sinal | Descrição | -| ----- | ------------------------------------------------------------------------------------------------------------------------------------------------- | --- | --- | --- | --- | -| ! | !e | -| | resulta em "verdadeiro" lógico se e era logicamente "falso". | -| | | | e1 | | e2 | -| | resulta em "verdadeiro" lógico se e1 ou e2 (ou ambos) são logicamente "verdadeiro". A expressão e2 só é avaliada se e1 é logicamente "falso". | -| && | e1 && e2 | -| | resulta em "verdadeiro" lógico se tanto e1 quanto e2 são logicamente "verdadeiro". | -| | A expressão e2 só é avaliada se e1 é logicamente "verdadeiro". | +| Sinal | Descrição | +| ----- | --------------------------------------------------------------------------------------------------------------------------------------------- | +| ! | !e | +| | resulta em "verdadeiro" lógico se e era logicamente "falso". | +| \|\| | e1 \|\| e2 | +| | resulta em "verdadeiro" lógico se e1 ou e2 (ou ambos) são logicamente "verdadeiro". A expressão e2 só é avaliada se e1 é logicamente "falso". | +| && | e1 && e2 | +| | resulta em "verdadeiro" lógico se tanto e1 quanto e2 são logicamente "verdadeiro". | +| | A expressão e2 só é avaliada se e1 é logicamente "verdadeiro". | ### • Diversos -| Sinal | Descrição | -| ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [] | a\[e\] | -| | índice de array: resulta na célula e do array a. | -| \{\} | a\{e\} | -| | índice de array: resulta no caractere e do array "empacotado" a. | -| () | f(e1,e2,...eN) | -| | resulta no valor retornado pela função f. A função é chamada com os argumentos e1, e2, . . . eN. A ordem de avaliação dos argumentos é indefinida (uma implementação pode escolher avaliar os argumentos da função em ordem reversa). | -| ? : | e1 ? e2 : e3 | -| | resulta em e2 ou e3, dependendo do valor de e1. A expressão condicional é uma expressão composta com um operador de duas partes, "?" e ":". A expressão e2 é avaliada se e1 é logicamente "verdadeiro", e3 é avaliada se e1 é logicamente "falso". | -| : | tagname: e | -| | sobrescrita de tag; o valor da expressão e não muda, mas sua tag muda. Veja página 68 para mais informações. | -| , | e1, e2 | -| | resulta em e2, e1 é avaliado antes de e2. Se usado em listas de argumentos de função ou uma expressão condicional, a expressão vírgula deve ser cercada por parênteses. | -| defined | defined s | -| | resulta no valor 1 se o símbolo está definido. O símbolo pode ser uma constante (página 98), ou uma variável global ou local. | -| | A tag desta expressão é bool:. | -| sizeof | sizeof s | -| | resulta no tamanho em "elementos" da variável especificada. Para variáveis simples e para arrays com uma única dimensão, um elemento é uma célula. Para arrays multidimensionais, o resultado é o número de elementos do array nessa dimensão — anexe [] ao nome do array para indicar uma dimensão inferior/mais menor. Se o tamanho de uma variável é desconhecido, o resultado é zero. | -| | Quando usado em um valor padrão para um argumento de função, a expressão é avaliada no ponto da chamada da função, em vez de na definição da função. | -| state | state s | -| | onde "s" é o nome de um estado que é opcionalmente prefixado com o nome do autômato, este operador resulta no valor 1 se o autômato está no estado indicado e em 0 caso contrário. | -| | A tag desta expressão é bool:. | -| tagof | tagof s | -| | resulta em um número único que representa a tag da variável, a constante, o resultado da função ou a etiqueta de tag. | -| | Quando usado em um valor padrão para um argumento de função, a expressão é avaliada no ponto da chamada da função, em vez de na definição da função. | -| char | e char | -| | resulta no número de células necessárias para conter um array empacotado de e caracteres. | +| Sinal | Descrição | +| ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [] | a[e] | +| | índice de array: resulta na célula e do array a. | +| {} | a{e} | +| | índice de array: resulta no caractere e do array "empacotado" a. | +| () | f(e1,e2,...eN) | +| | resulta no valor retornado pela função f. A função é chamada com os argumentos e1, e2, . . . eN. A ordem de avaliação dos argumentos é indefinida. | +| ? : | e1 ? e2 : e3 | +| | resulta em e2 ou e3, dependendo do valor de e1. A expressão condicional é uma expressão composta com um operador de duas partes, "?" e ":". A expressão e2 é avaliada se e1 é logicamente "verdadeiro", e3 é avaliada se e1 é logicamente "falso". | +| : | tagname: e | +| | sobrescrita de tag; o valor da expressão e não muda, mas sua tag muda. Veja página 68 para mais informações. | +| , | e1, e2 | +| | resulta em e2, e1 é avaliado antes de e2. Se usado em listas de argumentos de função ou uma expressão condicional, a expressão vírgula deve ser cercada por parênteses. | +| defined | defined s | +| | resulta no valor 1 se o símbolo está definido. O símbolo pode ser uma constante (página 98), ou uma variável global ou local. | +| | A tag desta expressão é bool:. | +| sizeof | sizeof s | +| | resulta no tamanho em "elementos" da variável especificada. Para variáveis simples e para arrays com uma única dimensão, um elemento é uma célula. | +| | Quando usado em um valor padrão para um argumento de função, a expressão é avaliada no ponto da chamada da função, em vez de na definição da função. | +| state | state s | +| | onde "s" é o nome de um estado que é opcionalmente prefixado com o nome do autômato, este operador resulta no valor 1 se o autômato está no estado indicado e em 0 caso contrário. | +| | A tag desta expressão é bool:. | +| tagof | tagof s | +| | resulta em um número único que representa a tag da variável, a constante, o resultado da função ou a etiqueta de tag. | +| | Quando usado em um valor padrão para um argumento de função, a expressão é avaliada no ponto da chamada da função, em vez de na definição da função. | +| char | e char | +| | resulta no número de células necessárias para conter um array empacotado de e caracteres. | ### • Precedência de operadores @@ -185,45 +184,45 @@ Se a ordem de avaliação da expressão não é explicitamente estabelecida por ela é determinada pelas regras de associação. Por exemplo: a*b/c é equivalente a (a*b)/c por causa da associação da esquerda para a direita, e a=b=c é equivalente a a=(b=c). -| Sinal | Descrição | | -| ------------------------------------ | ------------------------------------------------ | ------------- | ------------- | ------------- | -| () | chamada de função | esquerda-para-direita | -| [] | índice de array (célula) | | -| {} | índice de array (caractere) | | -| ! | não lógico | direita-para-esquerda | -| ~ | complemento de um | | -| - | complemento de dois | | -| ++ | incremento | | -| -- | decremento | | -| : | sobrescrita de tag | | -| char | converter número de caracteres empacotados para células | | -| defined | status de definição do símbolo | | -| sizeof | tamanho do símbolo em "elementos" | direita-para-esquerda | -| state | condição de autômato/estado | | -| tagof | número único para a tag | | -| \* | multiplicação | esquerda-para-direita | -| / | divisão | | -| % | módulo | | -| + | adição | esquerda-para-direita | -| - | subtração | | -| >> | deslocamento à direita | esquerda-para-direita | -| >>> | deslocamento lógico à direita | | -| \<\< | deslocamento à esquerda | | -| & | e bit a bit | esquerda-para-direita | -| ^ | ou exclusivo bit a bit | esquerda-para-direita | -| | | ou bit a bit | esquerda-para-direita | -| \< | menor que | esquerda-para-direita | -| \<= | menor ou igual a | | -| > | maior que | | -| >= | maior ou igual a | | -| == | igualdade | esquerda-para-direita | -| != | desigualdade | | -| && | e lógico | esquerda-para-direita | -| | | | ou lógico | esquerda-para-direita | -| ? : | condicional | direita-para-esquerda | -| = | atribuição | direita-para-esquerda | -| \*= /= %= += -= >>= >>>= \<\<= &= ^= | = | | | -| , | vírgula | esquerda-para-direita | +| Sinal | Descrição | Associatividade | +| ---------------------------------------- | ------------------------------------------------------- | --------------------- | +| () | chamada de função | esquerda-para-direita | +| [] | índice de array (célula) | esquerda-para-direita | +| {} | índice de array (caractere) | esquerda-para-direita | +| ! | não lógico | direita-para-esquerda | +| ~ | complemento de um | direita-para-esquerda | +| - | complemento de dois | direita-para-esquerda | +| ++ | incremento | direita-para-esquerda | +| -- | decremento | direita-para-esquerda | +| : | sobrescrita de tag | direita-para-esquerda | +| char | converter número de caracteres empacotados para células | direita-para-esquerda | +| defined | status de definição do símbolo | direita-para-esquerda | +| sizeof | tamanho do símbolo em "elementos" | direita-para-esquerda | +| state | condição de autômato/estado | direita-para-esquerda | +| tagof | número único para a tag | direita-para-esquerda | +| \* | multiplicação | esquerda-para-direita | +| / | divisão | esquerda-para-direita | +| % | módulo | esquerda-para-direita | +| + | adição | esquerda-para-direita | +| - | subtração | esquerda-para-direita | +| >> | deslocamento à direita | esquerda-para-direita | +| >>> | deslocamento lógico à direita | esquerda-para-direita | +| `<<` | deslocamento à esquerda | esquerda-para-direita | +| & | e bit a bit | esquerda-para-direita | +| ^ | ou exclusivo bit a bit | esquerda-para-direita | +| \| | ou bit a bit | esquerda-para-direita | +| `<` | menor que | esquerda-para-direita | +| `<=` | menor ou igual a | esquerda-para-direita | +| > | maior que | esquerda-para-direita | +| >= | maior ou igual a | esquerda-para-direita | +| == | igualdade | esquerda-para-direita | +| != | desigualdade | esquerda-para-direita | +| && | e lógico | esquerda-para-direita | +| \|\| | ou lógico | esquerda-para-direita | +| ? : | condicional | direita-para-esquerda | +| = | atribuição | direita-para-esquerda | +| `\*= /= %= += -= >>= >>>= <<= &= ^= \|=` | operadores combinados | direita-para-esquerda | +| , | vírgula | esquerda-para-direita | --- From 1cf8f37fe48e0975aa1fd34bd2ddec2cfaf9a095 Mon Sep 17 00:00:00 2001 From: dockfries Date: Tue, 17 Mar 2026 17:36:47 +0800 Subject: [PATCH 06/24] add colorMode config for docusaurus respect system dark mode --- frontend/docusaurus.config.ts | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/frontend/docusaurus.config.ts b/frontend/docusaurus.config.ts index 5c87fd26d3e..a8270171811 100644 --- a/frontend/docusaurus.config.ts +++ b/frontend/docusaurus.config.ts @@ -346,6 +346,11 @@ const config: Config = { // Optional: whether the insights feature is enabled or not on Docsearch (`false` by default) insights: false, }, + colorMode: { + defaultMode: "light", + disableSwitch: false, + respectPrefersColorScheme: true, + }, } satisfies Preset.ThemeConfig, }; From eeb8be1a6f4e1024dc1ee2fad491154e6ac043aa Mon Sep 17 00:00:00 2001 From: dockfries Date: Tue, 17 Mar 2026 18:05:20 +0800 Subject: [PATCH 07/24] update footer css style --- frontend/docusaurus.config.ts | 1 - frontend/src/css/custom.css | 2 ++ 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/frontend/docusaurus.config.ts b/frontend/docusaurus.config.ts index a8270171811..fee26e31a7b 100644 --- a/frontend/docusaurus.config.ts +++ b/frontend/docusaurus.config.ts @@ -252,7 +252,6 @@ const config: Config = { alt: "open.mp logo", src: "images/assets/logo.svg", }, - style: "dark", links: [ { title: "Documentations", diff --git a/frontend/src/css/custom.css b/frontend/src/css/custom.css index c93ecbe4d4d..821c2931316 100644 --- a/frontend/src/css/custom.css +++ b/frontend/src/css/custom.css @@ -48,6 +48,7 @@ h6 { --ifm-code-font-size: 95%; --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.1); --ifm-button-font-weight: 600; + --ifm-footer-background-color:rgba(255, 255, 255, 0.35); background-image: url(/images/assets/map.png); background-size: cover; @@ -66,6 +67,7 @@ h6 { --ifm-navbar-background-color: #1a202c; --ifm-color-secondary-button-background: #2c323d; --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.3); + --ifm-footer-background-color: rgba(26, 32, 44, 0.3); } html[data-theme="dark"] { From 67aea9bf2a993c8633537b70072d8c50eafad580 Mon Sep 17 00:00:00 2001 From: dockfries Date: Sat, 21 Mar 2026 15:32:19 +0800 Subject: [PATCH 08/24] fix some symbol issues in reference docs fix some symbol issues in reference docs --- .../reference/02-A-tutorial-introduction.md | 40 +++++++++---------- .../language/reference/04-Functions.md | 6 +-- .../language/reference/06-General-syntax.md | 6 +-- .../reference/07-Operators-and-expressions.md | 2 +- .../reference/02-A-tutorial-introduction.md | 36 ++++++++--------- .../language/reference/04-Functions.md | 6 +-- .../language/reference/06-General-syntax.md | 6 +-- .../reference/07-Operators-and-expressions.md | 2 +- .../reference/02-A-tutorial-introduction.md | 34 ++++++++-------- 9 files changed, 69 insertions(+), 69 deletions(-) diff --git a/frontend/docs/scripting/language/reference/02-A-tutorial-introduction.md b/frontend/docs/scripting/language/reference/02-A-tutorial-introduction.md index 3294a666499..0b750210492 100644 --- a/frontend/docs/scripting/language/reference/02-A-tutorial-introduction.md +++ b/frontend/docs/scripting/language/reference/02-A-tutorial-introduction.md @@ -1161,12 +1161,12 @@ counting from zero; here, the value of the first constant, A, is explicitly set _its predecessor incremented by any value (not just 1) —e.g., “(+= 5)”;_ -_its predecessor multiplied by any value —e.g., “(_= 3)”;\_ +_its predecessor multiplied by any value —e.g., “(*= 3)”;_ _its predecessor bit-shifted to the left by any value —e.g., “(\<\<= 1)”;_ Note that, in binary arithmetic, shifting left by one bit amounts to the same -as multiplying by two, meaning that `(/*= 2)` and `(<<= 1)` do the same thing. +as multiplying by two, meaning that `(*= 2)` and `(<<= 1)` do the same thing. When working with sets, a typical task that pops up is to determine the number of elements in the set. A straightforward function that does this is below: @@ -1661,28 +1661,28 @@ Listing: turtle.p @keypressed(key) { - /_ get current position */ + /* get current position */ new x, y wherexy x, y - /_ determine how the update the current position */ + /* determine how the update the current position */ switch (key) { - case ’u’: y-- /_ up */ - case ’d’: y++ /_ down */ - case ’l’: x-- /_ left */ - case ’r’: x++ /_ right */ - case ’\e’: exit /_ Escape = exit */ + case ’u’: y-- /* up */ + case ’d’: y++ /* down */ + case ’l’: x-- /* left */ + case ’r’: x++ /* right */ + case ’\e’: exit /* Escape = exit */ } - /_ adjust the cursor position and draw something */ + /* adjust the cursor position and draw something */ moveturtle x, y } moveturtle(x, y) { gotoxy x, y - print ’/*’ + print ’*’ gotoxy x, y } @@ -1879,7 +1879,7 @@ main() @keypressed(key) { state (key != ’/’) plain - state (key == ’/*’) comment + state (key == ’*’) comment echo ’/’ /* print ’/’ held back from previous state */ if (key != ’/’) echo key @@ -1888,13 +1888,13 @@ main() @keypressed(key) { echo key - state (key == ’/*’) star + state (key == ’*’) star } @keypressed(key) { echo key - state (key != ’/*’) comment + state (key != ’*’) comment state (key == ’/’) plain } @@ -2172,7 +2172,7 @@ new bool: button_memo switch (key) { case ’ ’: button_press - case ’/*’: mirt_detect + case ’*’: mirt_detect } } @@ -2417,13 +2417,13 @@ double as documentation, and the parser helps your documentation efforts in generating syntax descriptions and cross references. Every comment that starts with three slashes -(“/// ”) followed by white-space, or that starts with a slash and two stars (“//_/_ ”) +(“/// ”) followed by white-space, or that starts with a slash and two stars (“/** ”) followed by white-space is a special documentation comment. The pawn compiler extracts documentation comments and optionally writes these to a “report” file. See the application documentation, or appendix B, how to enable the report generation. -As an aside, comments that start with “/_” must still be closed with “_/”. +As an aside, comments that start with “/\*\*” must still be closed with “\*/”. Single line documentation comments (“///”) close at the end of the line. The report file is an XML file that can subsequently be transformed to HTML @@ -2651,8 +2651,8 @@ weekday(day, month, year) bool: readdate(&day, &month, &year) { print "Give a date (dd-mm-yyyy): " - day = getvalue(\_,’-’,’/’) - month = getvalue(\_,’-’,’/’) + day = getvalue(_,’-’,’/’) + month = getvalue(_,’-’,’/’) year = getvalue() return 1 <= month <= 12 && 1 <= day <= daysinmonth(month,year) } @@ -2737,7 +2737,7 @@ daysinmonth(month, year) { static daylist[] = { 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 } assert 1 <= month <= 12 - return daylist[month-1] + \_:(month == 2 && isleapyear(year)) + return daylist[month-1] + _:(month == 2 && isleapyear(year)) } ``` diff --git a/frontend/docs/scripting/language/reference/04-Functions.md b/frontend/docs/scripting/language/reference/04-Functions.md index a06a445fbbb..a897ce7d75c 100644 --- a/frontend/docs/scripting/language/reference/04-Functions.md +++ b/frontend/docs/scripting/language/reference/04-Functions.md @@ -349,7 +349,7 @@ Listing: increment usage ```c increment(a) -increment(a, \_) +increment(a, _) increment(a, 1) ``` @@ -381,8 +381,8 @@ Listing: divmod usage new p, q divmod(10, 3, p, q) -divmod(10, 3, p, \_) -divmod(10, 3, \_, q) +divmod(10, 3, p, _) +divmod(10, 3, _, q) divmod(10, 3, p) divmod 10, 3, p, q diff --git a/frontend/docs/scripting/language/reference/06-General-syntax.md b/frontend/docs/scripting/language/reference/06-General-syntax.md index daeeb266cb6..c8efaba354f 100644 --- a/frontend/docs/scripting/language/reference/06-General-syntax.md +++ b/frontend/docs/scripting/language/reference/06-General-syntax.md @@ -17,13 +17,13 @@ **Comments** - Text between the tokens /_ and _/ (both tokens may be at the same + Text between the tokens /* and */ (both tokens may be at the same line or at different lines) and text behind // (up to the end of the line) is a programming comment. The parser treats a comment as white space. Comments may not be nested. - A comment that starts with “/\*_ ” (two stars and white-space behind - the second star) and ends with “_/” is a documentation comment. + A comment that starts with “/** ” (two stars and white-space behind + the second star) and ends with “*/” is a documentation comment. A comment that starts with “/// ” (three slashes and white-space behind the third slash) is also a documentation comment. The parser may treat documentation comments in a special way; for example, it diff --git a/frontend/docs/scripting/language/reference/07-Operators-and-expressions.md b/frontend/docs/scripting/language/reference/07-Operators-and-expressions.md index a812b636e46..bdbc44fd1ff 100644 --- a/frontend/docs/scripting/language/reference/07-Operators-and-expressions.md +++ b/frontend/docs/scripting/language/reference/07-Operators-and-expressions.md @@ -150,7 +150,7 @@ A logical "false" is represented by an integer value of 0; a logical "true" is r | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | [] | a[e] | | | array index: results to cell e from array a. | -| {} | a{e} | +| {} | `a{e}` | | | array index: results to character e from "packed" array a. | | () | f(e1,e2,...eN) | | | results to the value returned by the function f. The function is called with the arguments e1, e2, . . . eN. The order of evaluation of the arguments is undefined. | diff --git a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/02-A-tutorial-introduction.md b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/02-A-tutorial-introduction.md index 2917edaba9d..72d02495034 100644 --- a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/02-A-tutorial-introduction.md +++ b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/02-A-tutorial-introduction.md @@ -934,12 +934,12 @@ counting from zero; here, the value of the first constant, A, is explicitly set _its predecessor incremented by any value (not just 1) —e.g., “(+= 5)”;_ -_its predecessor multiplied by any value —e.g., “(_= 3)”;\_ +_its predecessor multiplied by any value —e.g., “(*= 3)”;_ _its predecessor bit-shifted to the left by any value —e.g., “(\<\<= 1)”;_ Note that, in binary arithmetic, shifting left by one bit amounts to the same -as multiplying by two, meaning that `(/*= 2)` and `(<<= 1)` do the same thing. +as multiplying by two, meaning that `(*= 2)` and `(<<= 1)` do the same thing. When working with sets, a typical task that pops up is to determine the number of elements in the set. A straightforward function that does this is below: @@ -1340,28 +1340,28 @@ Listing: turtle.p @keypressed(key) { - /_ get current position */ + /* get current position */ new x, y wherexy x, y - /_ determine how the update the current position */ + /* determine how the update the current position */ switch (key) { - case ’u’: y-- /_ up */ - case ’d’: y++ /_ down */ - case ’l’: x-- /_ left */ - case ’r’: x++ /_ right */ - case ’\e’: exit /_ Escape = exit */ + case ’u’: y-- /* up */ + case ’d’: y++ /* down */ + case ’l’: x-- /* left */ + case ’r’: x++ /* right */ + case ’\e’: exit /* Escape = exit */ } - /_ adjust the cursor position and draw something */ + /* adjust the cursor position and draw something */ moveturtle x, y } moveturtle(x, y) { gotoxy x, y - print ’/*’ + print ’*’ gotoxy x, y } @@ -1504,7 +1504,7 @@ main() @keypressed(key) { state (key != ’/’) plain - state (key == ’/*’) comment + state (key == ’*’) comment echo ’/’ /* print ’/’ held back from previous state */ if (key != ’/’) echo key @@ -1513,13 +1513,13 @@ main() @keypressed(key) { echo key - state (key == ’/*’) star + state (key == ’*’) star } @keypressed(key) { echo key - state (key != ’/*’) comment + state (key != ’*’) comment state (key == ’/’) plain } @@ -1711,7 +1711,7 @@ new bool: button_memo switch (key) { case ’ ’: button_press - case ’/*’: mirt_detect + case ’*’: mirt_detect } } @@ -2073,8 +2073,8 @@ weekday(day, month, year) bool: readdate(&day, &month, &year) { print "Give a date (dd-mm-yyyy): " - day = getvalue(\_,’-’,’/’) - month = getvalue(\_,’-’,’/’) + day = getvalue(_,’-’,’/’) + month = getvalue(_,’-’,’/’) year = getvalue() return 1 <= month <= 12 && 1 <= day <= daysinmonth(month,year) } @@ -2159,7 +2159,7 @@ daysinmonth(month, year) { static daylist[] = { 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 } assert 1 <= month <= 12 - return daylist[month-1] + \_:(month == 2 && isleapyear(year)) + return daylist[month-1] + _:(month == 2 && isleapyear(year)) } ``` diff --git a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/04-Functions.md b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/04-Functions.md index 88122336529..dfe15a4a4d1 100644 --- a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/04-Functions.md +++ b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/04-Functions.md @@ -280,7 +280,7 @@ Listing: increment usage ```c increment(a) -increment(a, \_) +increment(a, _) increment(a, 1) ``` @@ -309,8 +309,8 @@ Listing: divmod usage new p, q divmod(10, 3, p, q) -divmod(10, 3, p, \_) -divmod(10, 3, \_, q) +divmod(10, 3, p, _) +divmod(10, 3, _, q) divmod(10, 3, p) divmod 10, 3, p, q diff --git a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/06-General-syntax.md b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/06-General-syntax.md index 393537d3756..dfee9b5e0dc 100644 --- a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/06-General-syntax.md +++ b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/06-General-syntax.md @@ -18,13 +18,13 @@ **Comentários** - Texto entre os tokens /_ e _/ (ambos os tokens podem estar na mesma + Texto entre os tokens /* e */ (ambos os tokens podem estar na mesma linha ou em linhas diferentes) e texto após // (até o final da linha) é um comentário de programação. O parser trata um comentário como espaço em branco. Comentários não podem ser aninhados. - Um comentário que começa com "/\*_ " (duas estrelas e espaço em branco - após a segunda estrela) e termina com "_/" é um comentário de documentação. + Um comentário que começa com "/** */ " (duas estrelas e espaço em branco + após a segunda estrela) e termina com "*/" é um comentário de documentação. Um comentário que começa com "/// " (três barras e espaço em branco após a terceira barra) também é um comentário de documentação. O parser pode tratar comentários de documentação de forma especial; por exemplo, diff --git a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/07-Operators-and-expressions.md b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/07-Operators-and-expressions.md index 31e09ab0c0d..e7e7ffc3b2a 100644 --- a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/07-Operators-and-expressions.md +++ b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/07-Operators-and-expressions.md @@ -150,7 +150,7 @@ Um "falso" lógico é representado por um valor inteiro de 0; um "verdadeiro" l | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [] | a[e] | | | índice de array: resulta na célula e do array a. | -| {} | a{e} | +| {} | `a{e}` | | | índice de array: resulta no caractere e do array "empacotado" a. | | () | f(e1,e2,...eN) | | | resulta no valor retornado pela função f. A função é chamada com os argumentos e1, e2, . . . eN. A ordem de avaliação dos argumentos é indefinida. | diff --git a/frontend/i18n/tr/docusaurus-plugin-content-docs/current/scripting/language/reference/02-A-tutorial-introduction.md b/frontend/i18n/tr/docusaurus-plugin-content-docs/current/scripting/language/reference/02-A-tutorial-introduction.md index 812b89ffee2..fb49f19c6c5 100644 --- a/frontend/i18n/tr/docusaurus-plugin-content-docs/current/scripting/language/reference/02-A-tutorial-introduction.md +++ b/frontend/i18n/tr/docusaurus-plugin-content-docs/current/scripting/language/reference/02-A-tutorial-introduction.md @@ -752,7 +752,7 @@ Daha dikkat çekici olan, enum anahtar kelimesi ve sabit listesini başlatan aç - öncülünün belirli bir değere sola kaydırılması —örneğin, `(<<= 1)`;- -Unutmayın ki ikili aritmetikte, bir bitin bir konum sola kaydırılması, iki ile çarpılması anlamına gelir, bu da `(/*= 2)` ve `(<<= 1)`'in aynı şeyi yaptığı anlamına gelir. +Unutmayın ki ikili aritmetikte, bir bitin bir konum sola kaydırılması, iki ile çarpılması anlamına gelir, bu da `(*= 2)` ve `(<<= 1)`'in aynı şeyi yaptığı anlamına gelir. Kümelerle çalışırken karşımıza çıkan tipik bir görev, kümedeki elemanların sayısını belirlemektir. Bu işlemi yapan basit bir işlev aşağıda gösterilmiştir: @@ -1088,21 +1088,21 @@ Listeleme: turtle.p @keypressed(key) { - /_ mevcut konumu al */ + /* mevcut konumu al */ yeni x, y wherexy x, y - /_ mevcut konumu nasıl güncelleyeceğini belirle */ + /* mevcut konumu nasıl güncelleyeceğini belirle */ switch (key) { - case 'u': y-- /_ yukarı */ - case 'd': y++ /_ aşağı */ - case 'l': x-- /_ sola */ - case 'r': x++ /_ sağa */ - case '\e': exit /_ Escape = çıkış */ + case 'u': y-- /* yukarı */ + case 'd': y++ /* aşağı */ + case 'l': x-- /* sola */ + case 'r': x++ /* sağa */ + case '\e': exit /* Escape = çıkış */ } - /_ imleç konumunu ayarla ve bir şeyler çiz */ + /* imleç konumunu ayarla ve bir şeyler çiz */ moveturtle x, y } @@ -1230,7 +1230,7 @@ main() @keypressed(key) { state (key != ’/’) plain - state (key == ’/*’) comment + state (key == ’*’) comment echo ’/’ /* Önceki durumdan gelen ’/’ karakterini yazdır */ if (key != ’/’) echo key @@ -1239,13 +1239,13 @@ main() @keypressed(key) { echo key - state (key == ’/*’) star + state (key == ’*’) star } @keypressed(key) { echo key - state (key != ’/*’) comment + state (key != ’*’) comment state (key == ’/’) plain } @@ -1523,9 +1523,9 @@ Bakım sırasında veya hatta başlangıçta, bir assertion tarafından yakalanm Programlar büyüdükçe, programın ve işlevlerin belgelenmesi özellikle bir ekiple çalışırken bakım için hayati öneme sahiptir. Pawn dil araçları, kodu belgelerken size yardımcı olacak bazı özelliklere sahiptir. Bir programı veya kütüphaneyi yorumlar içinde belgeleme, birkaç avantaja sahiptir - örneğin: belgeleme programla daha kolay bir şekilde güncellenebilir, programlama yorumları şimdi belgeleme olarak da kullanılır ve ayrıca ayrıştırıcı, sentaks açıklamaları ve çapraz referanslar oluşturmanıza yardımcı olur. -Her üç eğik çizgi ile başlayan yorum ("/// ") ve bir beyaz boşluktan sonra veya bir eğik çizgi ve iki yıldız ile başlayan yorum ("//_/ ") ve bir beyaz boşluktan sonra başlayan özel bir belgeleme yorumudur. Pawn derleyicisi belgeleme yorumlarını çıkarır ve bunları bir "rapor" dosyasına isteğe bağlı olarak yazar. Rapor oluşturmayı etkinleştirmek için uygulama belgelerine veya ek B'ye bakınız. +Her üç eğik çizgi ile başlayan yorum ("/// ") ve bir beyaz boşluktan sonra veya bir eğik çizgi ve iki yıldız ile başlayan yorum ("/** ") ve bir beyaz boşluktan sonra başlayan özel bir belgeleme yorumudur. Pawn derleyicisi belgeleme yorumlarını çıkarır ve bunları bir "rapor" dosyasına isteğe bağlı olarak yazar. Rapor oluşturmayı etkinleştirmek için uygulama belgelerine veya ek B'ye bakınız. -Ayrıca, "_/" ile başlayan yorumlar "_/ ile kapatılmalıdır". Tek satır belgeleme yorumları ("///") satırın sonunda kapanır. +Ayrıca, "/\*\*" ile başlayan yorumlar "\*/ ile kapatılmalıdır". Tek satır belgeleme yorumları ("///") satırın sonunda kapanır. Rapor dosyası, ardından bir XSL/XSLT stili sayesinde HTML belgesine dönüştürülebilen bir XML dosyasıdır veya basılı belgeler oluşturmak için diğer @@ -1742,8 +1742,8 @@ weekday(day, month, year) bool: readdate(&day, &month, &year) { print "Bir tarih girin (gg-aa-yyyy): "; - day = getvalue(\_, '-', '/'); - month = getvalue(\_, '-', '/'); + day = getvalue(_, '-', '/'); + month = getvalue(_, '-', '/'); year = getvalue(); return 1 <= month && month <= 12 && 1 <= day && day <= daysinmonth(month, year); } @@ -1820,7 +1820,7 @@ daysinmonth(month, year) { static daylist[] = { 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 }; assert 1 <= month && month <= 12; - return daylist[month - 1] + \_:(month == 2 && isleapyear(year)); + return daylist[month - 1] + _:(month == 2 && isleapyear(year)); } ``` From a5d35700d04233e66ac7ffcba18931f96149529c Mon Sep 17 00:00:00 2001 From: dockfries Date: Sat, 21 Mar 2026 15:44:05 +0800 Subject: [PATCH 09/24] prettier reference docs --- .../reference/02-A-tutorial-introduction.md | 4 +- .../reference/07-Operators-and-expressions.md | 2 +- .../language/reference/00-Contents.md | 2 +- .../language/reference/01-Foreword.md | 2 +- .../language/reference/05-The-preprocessor.md | 4 +- .../language/reference/06-General-syntax.md | 98 ++--- .../reference/02-A-tutorial-introduction.md | 4 +- .../language/reference/06-General-syntax.md | 40 +- .../reference/07-Operators-and-expressions.md | 2 +- .../reference/10-Proposed-function-library.md | 178 ++++---- .../language/reference/12-Assorted-tips.md | 41 +- .../language/reference/13-Appendices.md | 395 +++++++++--------- .../language/reference/01-Foreword.md | 4 +- .../reference/02-A-tutorial-introduction.md | 75 ++-- .../reference/03-Data-and-declarations.md | 2 +- 15 files changed, 432 insertions(+), 421 deletions(-) diff --git a/frontend/docs/scripting/language/reference/02-A-tutorial-introduction.md b/frontend/docs/scripting/language/reference/02-A-tutorial-introduction.md index 0b750210492..96c68bab933 100644 --- a/frontend/docs/scripting/language/reference/02-A-tutorial-introduction.md +++ b/frontend/docs/scripting/language/reference/02-A-tutorial-introduction.md @@ -1161,7 +1161,7 @@ counting from zero; here, the value of the first constant, A, is explicitly set _its predecessor incremented by any value (not just 1) —e.g., “(+= 5)”;_ -_its predecessor multiplied by any value —e.g., “(*= 3)”;_ +_its predecessor multiplied by any value —e.g., “(\*= 3)”;_ _its predecessor bit-shifted to the left by any value —e.g., “(\<\<= 1)”;_ @@ -2417,7 +2417,7 @@ double as documentation, and the parser helps your documentation efforts in generating syntax descriptions and cross references. Every comment that starts with three slashes -(“/// ”) followed by white-space, or that starts with a slash and two stars (“/** ”) +(“/// ”) followed by white-space, or that starts with a slash and two stars (“/\*\* ”) followed by white-space is a special documentation comment. The pawn compiler extracts documentation comments and optionally writes these to a “report” file. See the application diff --git a/frontend/docs/scripting/language/reference/07-Operators-and-expressions.md b/frontend/docs/scripting/language/reference/07-Operators-and-expressions.md index bdbc44fd1ff..039252bb04b 100644 --- a/frontend/docs/scripting/language/reference/07-Operators-and-expressions.md +++ b/frontend/docs/scripting/language/reference/07-Operators-and-expressions.md @@ -150,7 +150,7 @@ A logical "false" is represented by an integer value of 0; a logical "true" is r | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | [] | a[e] | | | array index: results to cell e from array a. | -| {} | `a{e}` | +| {} | `a{e}` | | | array index: results to character e from "packed" array a. | | () | f(e1,e2,...eN) | | | results to the value returned by the function f. The function is called with the arguments e1, e2, . . . eN. The order of evaluation of the arguments is undefined. | diff --git a/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/language/reference/00-Contents.md b/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/language/reference/00-Contents.md index d329441fb96..a39ca41bb95 100644 --- a/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/language/reference/00-Contents.md +++ b/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/language/reference/00-Contents.md @@ -75,4 +75,4 @@ Eerste Industriestraat 19–21, 1401VL Bussum The Netherlands (Pays Bas) ∟ [منطق](13-Appendices#rationale) - صفحه 174-181 -∟ [مجوز](13-Appendices#license) - صفحه 181-183 \ No newline at end of file +∟ [مجوز](13-Appendices#license) - صفحه 181-183 diff --git a/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/language/reference/01-Foreword.md b/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/language/reference/01-Foreword.md index b5d0145965e..e27d6f74a20 100644 --- a/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/language/reference/01-Foreword.md +++ b/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/language/reference/01-Foreword.md @@ -72,4 +72,4 @@ pawn در آن حوزه کلیدی انعطاف‌پذیر است: فراخوا --- -[برگشت به فهرست مطالب](00-Contents) \ No newline at end of file +[برگشت به فهرست مطالب](00-Contents) diff --git a/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/language/reference/05-The-preprocessor.md b/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/language/reference/05-The-preprocessor.md index 5ce9f441d88..256cfe191dc 100644 --- a/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/language/reference/05-The-preprocessor.md +++ b/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/language/reference/05-The-preprocessor.md @@ -122,7 +122,7 @@ new c = a(8) ``` -به "new c = (1+(2*(8)))" ارزیابی می‌شه، حتی اگر macro "b" در زمان تعریف "a" تعریف نشده بود. +به "new c = (1+(2\*(8)))" ارزیابی می‌شه، حتی اگر macro "b" در زمان تعریف "a" تعریف نشده بود. pattern matching به قوانین زیر محدود شده: @@ -132,7 +132,7 @@ pattern matching به قوانین زیر محدود شده: - pattern نمی‌تونه با یک پارامتر تمام بشه؛ pattern ای مثل "set:%1=%2" غیرقانونی هست. اگر می‌خوای با انتهای یک statement match کنی، می‌تونی یک semicolon در انتهای pattern اضافه کنی. اگر semicolon ها در انتهای هر statement اختیاری باشن، semicolon با newline در source هم match می‌کنه. -- pattern باید با یک حرف، یک underscore، یا یک کاراکتر "@" شروع بشه. اولین بخش pattern که از کاراکترهای alphanumeric (به علاوه "_" و/"@") تشکیل شده "نام" یا "prefix" macro هست. روی defined operator و directive #undef، prefix macro رو مشخص می‌کنی. +- pattern باید با یک حرف، یک underscore، یا یک کاراکتر "@" شروع بشه. اولین بخش pattern که از کاراکترهای alphanumeric (به علاوه "\_" و/"@") تشکیل شده "نام" یا "prefix" macro هست. روی defined operator و directive #undef، prefix macro رو مشخص می‌کنی. - وقتی pattern رو match می‌کنی، preprocessor white space بین نمادهای غیرalphanumeric و white space بین یک نماد alphanumeric و یک غیرalphanumeric رو نادیده می‌گیره، با یک استثنا: بین دو نماد یکسان، white space نادیده گرفته نمی‌شه. بنابراین: `pattern abc(+-) با "abc ( + - )" match می‌کنه pattern abc(--) با "abc ( -- )" match می‌کنه` ولی با `"abc(- -)"` match نمی‌کنه diff --git a/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/language/reference/06-General-syntax.md b/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/language/reference/06-General-syntax.md index 7effb640d4b..a3be2844c13 100644 --- a/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/language/reference/06-General-syntax.md +++ b/frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/language/reference/06-General-syntax.md @@ -29,24 +29,24 @@ **کلمات رزرو شده (کلیدواژه‌ها)** | Statement ها | عملگرها | Directive ها | دیگر | -| ------------ | -------- | ------------ | -------- | -| assert | char | #assert | const | -| break | defined | #define | enum | -| case | sizeof | #else | forward | -| continue | state | #elseif | native | -| default | tagof | #emit | new | -| do | | #endif | operator | -| else | | #endinput | public | -| exit | | #endscript | static | -| for | | #error | stock | -| goto | | #file | | -| if | | #if | | -| return | | #include | | -| sleep | | #line | | -| state | | #pragma | | -| switch | | #section | | -| while | | #tryinclude | | -| | | #undef | | +| ------------ | ------- | ------------ | -------- | +| assert | char | #assert | const | +| break | defined | #define | enum | +| case | sizeof | #else | forward | +| continue | state | #elseif | native | +| default | tagof | #emit | new | +| do | | #endif | operator | +| else | | #endinput | public | +| exit | | #endscript | static | +| for | | #error | stock | +| goto | | #file | | +| if | | #if | | +| return | | #include | | +| sleep | | #line | | +| state | | #pragma | | +| switch | | #section | | +| while | | #tryinclude | | +| | | #undef | | علاوه بر کلمات رزرو شده، pawn چندین ثابت از پیش تعریف شده هم داره، نمی‌تونی از نام‌های نمادی ثابت‌های از پیش تعریف شده برای نام‌های متغیر یا تابع استفاده کنی. @@ -72,21 +72,21 @@ یک کاراکتر ASCII محصور در single quote ها یک ثابت کاراکتر هست (مثلاً: 'a', '7', '\$'). ثابت‌های کاراکتر به عنوان ثابت‌های عددی در نظر گرفته می‌شن. -| Escape sequence ها | | | -| ------------------ | --- | ------------------------------------------ | -| '\a' | | هشدار صوتی (beep) | -| '\b' | | Backspace | -| '\e' | | Escape | -| '\f' | | Formfeed | -| '\n' | | Newline | -| '\r' | | Carriage Return | -| '\t' | | Horizontal tab | -| '\v' | | Vertical tab | -| '\\' | \ | کاراکتر escape | -| '\'' | ' | single quote | -| '\"' | " | double quote | -| '\% | % | علامت درصد | -| '\ddd;' | | کد کاراکتر با کد دهدهی "ddd" | +| Escape sequence ها | | | +| ------------------ | --- | --------------------------------- | +| '\a' | | هشدار صوتی (beep) | +| '\b' | | Backspace | +| '\e' | | Escape | +| '\f' | | Formfeed | +| '\n' | | Newline | +| '\r' | | Carriage Return | +| '\t' | | Horizontal tab | +| '\v' | | Vertical tab | +| '\\' | \ | کاراکتر escape | +| '\'' | ' | single quote | +| '\"' | " | double quote | +| '\% | % | علامت درصد | +| '\ddd;' | | کد کاراکتر با کد دهدهی "ddd" | | '\xhhh;' | | کد کاراکتر با کد هگزادسیمال "hhh" | semicolon بعد از کدهای ddd; و xhhh; اختیاری هست. هدفش دادن یک نماد پایان صریح به escape sequence وقتی در یک ثابت string استفاده می‌شه هست. @@ -167,25 +167,25 @@ name [ increment ] token name ای که بعد از کلیدواژه enum می‌آد اختیاری هست. اگر شامل بشه، و اگر نام‌های نماد tag صریح نداشته باشن، این نام به عنوان نام tag برای هر نماد در لیست ثابت استفاده می‌شه. علاوه بر این، دستور enum یک ثابت اضافی با نام برای نام ثابت و نام tag ایجاد می‌کنه. مقدار آخرین ثابت مقدار آخرین نماد در لیست ثابت به علاوه مقدار increment اون آخرین ثابت هست. -token increment ای که بعد از token نام اختیاری می‌آد هم اختیاری هست. اگر شامل بشه، یک قانون post-increment متفاوت مشخص می‌کنه. به صورت پیش‌فرض، یک enum مقدار هر ثابت متوالی رو با 1 increment می‌کنه، ولی می‌تونی قانون متفاوتی با syntax "(operator constant)" مشخص کنی، که operator باید +=، *= یا `<<=` باشه. عملگر += یک increment جمعی ایجاد می‌کنه، *= و `<<=` یک increment ضربی ایجاد می‌کنن. ثابت ممکنه یک مقدار literal یا یک ثابت نمادین باشه. قانون increment باید در پرانتز محصور بشه. اگر هیچ قانون increment ای مشخص نشده، پرانتزها هم ممکنه حذف بشن. +token increment ای که بعد از token نام اختیاری می‌آد هم اختیاری هست. اگر شامل بشه، یک قانون post-increment متفاوت مشخص می‌کنه. به صورت پیش‌فرض، یک enum مقدار هر ثابت متوالی رو با 1 increment می‌کنه، ولی می‌تونی قانون متفاوتی با syntax "(operator constant)" مشخص کنی، که operator باید +=، _= یا `<<=` باشه. عملگر += یک increment جمعی ایجاد می‌کنه، _= و `<<=` یک increment ضربی ایجاد می‌کنن. ثابت ممکنه یک مقدار literal یا یک ثابت نمادین باشه. قانون increment باید در پرانتز محصور بشه. اگر هیچ قانون increment ای مشخص نشده، پرانتزها هم ممکنه حذف بشن. یک ثابت نمادین که به صورت محلی تعریف شده، در سراسر بلوک معتبر هست. یک ثابت نمادین محلی نمی‌تونه همون نام یک متغیر (محلی یا global)، یک تابع، یا ثابت دیگه (محلی یا global) رو داشته باشه. **ثابت‌های از پیش تعریف شده** -| نام | توضیحات | -| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| cellbits | اندازه یک cell به bit؛ معمولاً 32. | -| cellmax | بزرگ‌ترین مقدار مثبت معتبری که یک cell می‌تونه نگه داره؛ معمولاً 2147483647. | -| cellmin | بزرگ‌ترین مقدار منفی معتبری که یک cell می‌تونه نگه داره؛ معمولاً -2147483648. | -| charbits | اندازه یک کاراکتر packed به bit؛ معمولاً 8. | -| charmax | بزرگ‌ترین مقدار کاراکتر packed معتبر؛ معمولاً یک کاراکتر packed 8-bit هست و حداکثر مقدار معتبر بنابراین 255 هست. | -| charmin | کوچک‌ترین مقدار کاراکتر معتبر، برای هم مقادیر packed و هم unpacked؛ فعلاً روی صفر (0) تنظیم شده. | +| نام | توضیحات | +| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| cellbits | اندازه یک cell به bit؛ معمولاً 32. | +| cellmax | بزرگ‌ترین مقدار مثبت معتبری که یک cell می‌تونه نگه داره؛ معمولاً 2147483647. | +| cellmin | بزرگ‌ترین مقدار منفی معتبری که یک cell می‌تونه نگه داره؛ معمولاً -2147483648. | +| charbits | اندازه یک کاراکتر packed به bit؛ معمولاً 8. | +| charmax | بزرگ‌ترین مقدار کاراکتر packed معتبر؛ معمولاً یک کاراکتر packed 8-bit هست و حداکثر مقدار معتبر بنابراین 255 هست. | +| charmin | کوچک‌ترین مقدار کاراکتر معتبر، برای هم مقادیر packed و هم unpacked؛ فعلاً روی صفر (0) تنظیم شده. | | debug | سطح debug: 2 اگر parser اطلاعات نمادین کامل به علاوه بررسی bounds زمان اجرا ایجاد کنه، 1 اگر parser فقط بررسی زمان اجرا تولید کنه (assertion ها و بررسی bounds آرایه)، و 0 (صفر) اگر همه پشتیبانی debug و بررسی زمان اجرا خاموش شده باشه. | -| false | 0 (این ثابت به عنوان bool: tagged شده) | -| \_\_Pawn | شماره نسخه pawn compiler در Binary Coded Decimals (BCD) —یعنی، برای نسخه 2.8.1 ثابت "0x281" هست. | -| true | 1 (این ثابت به عنوان bool: tagged شده) | -| ucharmax | بزرگ‌ترین مقدار کاراکتر unpacked، مقدارش به اندازه یک cell بستگی داره. یک استفاده معمول برای این ثابت بررسی اینکه آیا یک string packed هست یا unpacked، صفحه 137 رو ببین. | +| false | 0 (این ثابت به عنوان bool: tagged شده) | +| \_\_Pawn | شماره نسخه pawn compiler در Binary Coded Decimals (BCD) —یعنی، برای نسخه 2.8.1 ثابت "0x281" هست. | +| true | 1 (این ثابت به عنوان bool: tagged شده) | +| ucharmax | بزرگ‌ترین مقدار کاراکتر unpacked، مقدارش به اندازه یک cell بستگی داره. یک استفاده معمول برای این ثابت بررسی اینکه آیا یک string packed هست یا unpacked، صفحه 137 رو ببین. | **نام‌های Tag** @@ -193,9 +193,9 @@ token increment ای که بعد از token نام اختیاری می‌آد ه **نام‌های tag از پیش تعریف شده** -| نام | توضیحات | -| ------ | --------------------------------------------------------------------------------------- | -| bool: | برای flag های "true/false". ثابت‌های از پیش تعریف شده true و false این tag رو دارن. | +| نام | توضیحات | +| ------ | ----------------------------------------------------------------------------------------- | +| bool: | برای flag های "true/false". ثابت‌های از پیش تعریف شده true و false این tag رو دارن. | | Fixed: | اعداد rational معمولاً این tag رو دارن وقتی پشتیبانی fixed point فعال باشه (صفحه 121). | | Float: | اعداد rational معمولاً این tag رو دارن وقتی پشتیبانی floating point فعال باشه (صفحه 121). | diff --git a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/02-A-tutorial-introduction.md b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/02-A-tutorial-introduction.md index 72d02495034..982e0c340d9 100644 --- a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/02-A-tutorial-introduction.md +++ b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/02-A-tutorial-introduction.md @@ -934,7 +934,7 @@ counting from zero; here, the value of the first constant, A, is explicitly set _its predecessor incremented by any value (not just 1) —e.g., “(+= 5)”;_ -_its predecessor multiplied by any value —e.g., “(*= 3)”;_ +_its predecessor multiplied by any value —e.g., “(\*= 3)”;_ _its predecessor bit-shifted to the left by any value —e.g., “(\<\<= 1)”;_ @@ -2201,7 +2201,7 @@ Como o restante do relatório está em XML (e a forma mais comum de gerar docume | name | info | | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | -| ` ` | Preformatted source code in a monospaced font; although the “&”, “\<” and “>” must be typed as “&”, “<” and “&rt;” respectively. | +| ` ` | Preformatted source code in a monospaced font; although the “&”, “\<” and “>” must be typed as “&”, “<” and “&rt;” respectively. | | ` ` | Text set under the sub-header “Example”. | | ` ` | A parameter description, with the parameter name appearing inside the opening tag (the “name=” option) and the parameter description following it. | | `` | A reference to a parameter, with the parameter name appearing inside the opening tag (the “name=” option). | diff --git a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/06-General-syntax.md b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/06-General-syntax.md index dfee9b5e0dc..cff1ad4568d 100644 --- a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/06-General-syntax.md +++ b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/06-General-syntax.md @@ -119,9 +119,9 @@ são assumidas como constantes numéricas. | '\\' | \ | o caractere de escape | | '\'' | ' | aspas simples | | '\"' | " | aspas duplas | -| '\% | % | sinal de porcentagem | -| '\ddd;' | | código do caractere com código decimal "ddd" | -| '\xhhh;' | | código do caractere com código hexadecimal "hhh" | +| '\% | % | sinal de porcentagem | +| '\ddd;' | | código do caractere com código decimal "ddd" | +| '\xhhh;' | | código do caractere com código hexadecimal "hhh" | O ponto e vírgula após os códigos ddd; e xhhh; é opcional. Seu propósito é dar à sequência de escape um símbolo de @@ -276,19 +276,19 @@ que uma variável (local ou global), uma função ou outra constante **Constantes predefinidas** -| Nome | Descrição | -| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| cellbits | O tamanho de uma célula em bits; geralmente 32. | -| cellmax | O maior valor positivo válido que uma célula pode conter; geralmente 2147483647. | -| cellmin | O maior valor negativo válido que uma célula pode conter; geralmente -2147483648. | -| charbits | O tamanho de um caractere empacotado em bits; geralmente 8. | -| charmax | O maior valor válido de caractere empacotado; geralmente um caractere empacotado é de 8 bits e o valor máximo válido é 255. | -| charmin | O menor valor válido de caractere, tanto para valores empacotados quanto desempacotados; atualmente definido como zero (0). | -| debug | O nível de debug: 2 se o parser cria informações simbólicas completas mais verificação de limites em tempo de execução, 1 se o parser gera apenas verificação em tempo de execução (assertions e verificações de limites de array), e 0 (zero) se todo suporte de debug foi desativado. | -| false | 0 (esta constante é marcada como bool:) | -| \_\_Pawn | O número da versão do compilador pawn em Decimais Codificados em Binário (BCD) — ou seja, para a versão 2.8.1 a constante é "0x281". | -| true | 1 (esta constante é marcada como bool:) | -| ucharmax | O maior valor de caractere desempacotado, seu valor depende do tamanho de uma célula. Um uso típico para esta constante é verificar se uma string é empacotada ou desempacotada, veja página 137. | +| Nome | Descrição | +| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| cellbits | O tamanho de uma célula em bits; geralmente 32. | +| cellmax | O maior valor positivo válido que uma célula pode conter; geralmente 2147483647. | +| cellmin | O maior valor negativo válido que uma célula pode conter; geralmente -2147483648. | +| charbits | O tamanho de um caractere empacotado em bits; geralmente 8. | +| charmax | O maior valor válido de caractere empacotado; geralmente um caractere empacotado é de 8 bits e o valor máximo válido é 255. | +| charmin | O menor valor válido de caractere, tanto para valores empacotados quanto desempacotados; atualmente definido como zero (0). | +| debug | O nível de debug: 2 se o parser cria informações simbólicas completas mais verificação de limites em tempo de execução, 1 se o parser gera apenas verificação em tempo de execução (assertions e verificações de limites de array), e 0 (zero) se todo suporte de debug foi desativado. | +| false | 0 (esta constante é marcada como bool:) | +| \_\_Pawn | O número da versão do compilador pawn em Decimais Codificados em Binário (BCD) — ou seja, para a versão 2.8.1 a constante é "0x281". | +| true | 1 (esta constante é marcada como bool:) | +| ucharmax | O maior valor de caractere desempacotado, seu valor depende do tamanho de uma célula. Um uso típico para esta constante é verificar se uma string é empacotada ou desempacotada, veja página 137. | **Nomes de tag** @@ -296,10 +296,10 @@ Uma tag consiste em um identificador seguido por dois pontos. Não pode haver es **Nomes de tag predefinidos** -| Nome | Descrição | -| ------ | ------------------------------------------------------------------------------------------------ | -| bool: | Para flags "verdadeiro/falso". As constantes predefinidas true e false têm esta tag. | -| Fixed: | Números racionais tipicamente têm esta tag quando o suporte a ponto fixo está habilitado (página 121). | +| Nome | Descrição | +| ------ | ----------------------------------------------------------------------------------------------------------- | +| bool: | Para flags "verdadeiro/falso". As constantes predefinidas true e false têm esta tag. | +| Fixed: | Números racionais tipicamente têm esta tag quando o suporte a ponto fixo está habilitado (página 121). | | Float: | Números racionais tipicamente têm esta tag quando o suporte a ponto flutuante está habilitado (página 121). | --- diff --git a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/07-Operators-and-expressions.md b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/07-Operators-and-expressions.md index e7e7ffc3b2a..0f0f9cd760a 100644 --- a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/07-Operators-and-expressions.md +++ b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/07-Operators-and-expressions.md @@ -150,7 +150,7 @@ Um "falso" lógico é representado por um valor inteiro de 0; um "verdadeiro" l | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [] | a[e] | | | índice de array: resulta na célula e do array a. | -| {} | `a{e}` | +| {} | `a{e}` | | | índice de array: resulta no caractere e do array "empacotado" a. | | () | f(e1,e2,...eN) | | | resulta no valor retornado pela função f. A função é chamada com os argumentos e1, e2, . . . eN. A ordem de avaliação dos argumentos é indefinida. | diff --git a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/10-Proposed-function-library.md b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/10-Proposed-function-library.md index 98103597c2e..aaea6b5da30 100644 --- a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/10-Proposed-function-library.md +++ b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/10-Proposed-function-library.md @@ -13,96 +13,96 @@ O módulo "core" consiste em um conjunto de funções que suportam a linguagem em si. Várias das funções são necessárias para extrair argumentos de uma lista de argumentos variáveis (veja página 80). -| clamp | | Força um valor dentro de um intervalo | -| -------- | ----------------------------------------------------------------------------------------------------------- | -------------------------------------: | -| Sintaxe | clamp(valor, min=cellmin, max=cellmax) | | -| | valor | O valor a forçar em um intervalo | -| | min | O limite inferior do intervalo. | -| | max | O limite superior do intervalo. | -| Retorna | valor se estiver no intervalo min – max; min se valor for menor que min; e max se valor for maior que max. | | -| Veja também | max, min | | - -| funcidx | | Retorna um índice de função pública | -| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------: | -| Sintaxe | funcidx(const nome[]) | | -| Retorna | O índice da função pública nomeada. Se nenhuma função pública com o nome dado existir, funcidx retorna −1. | | -| Notas: | Um aplicativo host executa uma função pública do script passando o índice da função pública para amx_Exec. Com esta função, o script pode consultar o índice de uma função pública e assim retornar a "próxima função a chamar" para o aplicativo. | | - -| getarg | | Obtém um argumento | -| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------: | -| Sintaxe | getarg(arg, index=0) | | -| | arg | O número de sequência do argumento, use 0 para o primeiro. | -| | index | O índice, caso arg se refira a um array. | -| Retorna | O valor do argumento | | -| Notas: | Esta função recupera um argumento de uma lista de argumentos variáveis. Quando o argumento é um array, o parâmetro index especifica o índice no array. O valor de retorno é o argumento recuperado. | | -| Veja também | numargs, setarg | | - -| heapspace | | Retorna espaço livre no heap | -| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------: | -| Sintaxe | heapspace() | | +| clamp | | Força um valor dentro de um intervalo | +| ----------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------: | +| Sintaxe | clamp(valor, min=cellmin, max=cellmax) | | +| | valor | O valor a forçar em um intervalo | +| | min | O limite inferior do intervalo. | +| | max | O limite superior do intervalo. | +| Retorna | valor se estiver no intervalo min – max; min se valor for menor que min; e max se valor for maior que max. | | +| Veja também | max, min | | + +| funcidx | | Retorna um índice de função pública | +| ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------: | +| Sintaxe | funcidx(const nome[]) | | +| Retorna | O índice da função pública nomeada. Se nenhuma função pública com o nome dado existir, funcidx retorna −1. | | +| Notas: | Um aplicativo host executa uma função pública do script passando o índice da função pública para amx_Exec. Com esta função, o script pode consultar o índice de uma função pública e assim retornar a "próxima função a chamar" para o aplicativo. | | + +| getarg | | Obtém um argumento | +| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------: | +| Sintaxe | getarg(arg, index=0) | | +| | arg | O número de sequência do argumento, use 0 para o primeiro. | +| | index | O índice, caso arg se refira a um array. | +| Retorna | O valor do argumento | | +| Notas: | Esta função recupera um argumento de uma lista de argumentos variáveis. Quando o argumento é um array, o parâmetro index especifica o índice no array. O valor de retorno é o argumento recuperado. | | +| Veja também | numargs, setarg | | + +| heapspace | | Retorna espaço livre no heap | +| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------: | +| Sintaxe | heapspace() | | | Retorna | O espaço livre no heap. A pilha e o heap ocupam uma área de memória compartilhada, então este valor indica o número de bytes restantes tanto para a pilha quanto para o heap. | | -| Notas: | Na ausência de recursão, o parser pawn também pode dar uma estimativa do espaço de pilha/heap necessário. | | - -| max | | Retorna o maior de dois números | -| -------- | ------------------------------------- | -------------------------------------------------: | -| Sintaxe | max(valor1, valor2) | | -| | valor1 | | -| | valor2 | Os dois valores para os quais encontrar o maior. | -| Retorna | O maior valor de valor1 e valor2 | | -| Veja também | clamp, min | | - -| min | | Retorna o menor de dois números | -| -------- | ------------------------------------- | -------------------------------------------------: | -| Sintaxe | min(valor1, valor2) | | -| | valor1 | | -| | valor2 | Os dois valores para os quais encontrar o menor. | -| Retorna | O menor valor de valor1 e valor2 | | -| Veja também | clamp, max | | - -| numargs | | Retorna o número de argumentos | -| -------- | --------------------------------------------------------------------------------------------------------------- | -----------------------------: | -| Sintaxe | numargs() | | -| Retorna | O número de argumentos passados para uma função; numargs é útil dentro de funções com uma lista de argumentos variáveis | | -| Veja também | getarg, setarg | | - -| random | | Retorna um número pseudo-aleatório | -| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -----------------------------------: | -| Sintaxe | random(max) | | -| | max | O limite para o número aleatório | -| Retorna | Um número pseudo-aleatório no intervalo 0 - max-1 | | -| Notas: | O gerador de números aleatórios padrão do pawn é provavelmente um gerador de números pseudo-aleatórios congruente linear com um intervalo e um período de 2³¹. Geradores de números pseudo-aleatórios congruentes lineares sofrem de correlação serial (especialmente nos bits baixos) e é inadequado para aplicações que requerem números aleatórios de alta qualidade. | | - -| setarg | | | -| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------: | -| Sintaxe | setarg(arg, index=0, valor) | | -| | arg | O número de sequência do argumento, use 0 para o primeiro | -| | index | O índice, caso arg se refira a um array | -| | valor | O valor para definir o argumento | -| Retorna | true em caso de sucesso e false se o argumento ou o índice forem inválidos | | -| Notas: | Esta função define o valor de um argumento de uma lista de argumentos variáveis. Quando o argumento é um array, o parâmetro index especifica o índice no array. | | -| Veja também | getarg, numargs | | - -| swapchars | | Troca bytes em uma célula | -| --------- | ----------------------------------------------------------------------------------------------- | -----------------------------------------: | -| Sintaxe | swapchars(c) | | -| | c | O valor para o qual trocar os bytes | -| Retorna | Um valor onde os bytes no parâmetro "c" são trocados (o byte mais baixo se torna o byte mais alto) | | - -| tolower | | Converte um caractere para minúscula | -| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -----------------------------------------: | -| Sintaxe | tolower(c) | | -| | c | O caractere a converter para minúscula. | -| Retorna | A variante maiúscula do caractere de entrada, se existir, ou o código de caractere inalterado de "c" se a letra "c" não tiver equivalente minúsculo. | | -| Notas: | O suporte para caracteres acentuados é dependente da plataforma | | -| Veja também | toupper | | - -| toupper | | Converte um caractere para maiúscula | -| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -----------------------------------------: | -| Sintaxe | toupper(c) | | -| | c | O caractere a converter para maiúscula. | -| Retorna | A variante minúscula do caractere de entrada, se existir, ou o código de caractere inalterado de "c" se a letra "c" não tiver equivalente maiúsculo. | | -| Notas: | O suporte para caracteres acentuados é dependente da plataforma | | -| Veja também | tolower | | +| Notas: | Na ausência de recursão, o parser pawn também pode dar uma estimativa do espaço de pilha/heap necessário. | | + +| max | | Retorna o maior de dois números | +| ----------- | -------------------------------- | -----------------------------------------------: | +| Sintaxe | max(valor1, valor2) | | +| | valor1 | | +| | valor2 | Os dois valores para os quais encontrar o maior. | +| Retorna | O maior valor de valor1 e valor2 | | +| Veja também | clamp, min | | + +| min | | Retorna o menor de dois números | +| ----------- | -------------------------------- | -----------------------------------------------: | +| Sintaxe | min(valor1, valor2) | | +| | valor1 | | +| | valor2 | Os dois valores para os quais encontrar o menor. | +| Retorna | O menor valor de valor1 e valor2 | | +| Veja também | clamp, max | | + +| numargs | | Retorna o número de argumentos | +| ----------- | ----------------------------------------------------------------------------------------------------------------------- | -----------------------------: | +| Sintaxe | numargs() | | +| Retorna | O número de argumentos passados para uma função; numargs é útil dentro de funções com uma lista de argumentos variáveis | | +| Veja também | getarg, setarg | | + +| random | | Retorna um número pseudo-aleatório | +| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------: | +| Sintaxe | random(max) | | +| | max | O limite para o número aleatório | +| Retorna | Um número pseudo-aleatório no intervalo 0 - max-1 | | +| Notas: | O gerador de números aleatórios padrão do pawn é provavelmente um gerador de números pseudo-aleatórios congruente linear com um intervalo e um período de 2³¹. Geradores de números pseudo-aleatórios congruentes lineares sofrem de correlação serial (especialmente nos bits baixos) e é inadequado para aplicações que requerem números aleatórios de alta qualidade. | | + +| setarg | | | +| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------: | +| Sintaxe | setarg(arg, index=0, valor) | | +| | arg | O número de sequência do argumento, use 0 para o primeiro | +| | index | O índice, caso arg se refira a um array | +| | valor | O valor para definir o argumento | +| Retorna | true em caso de sucesso e false se o argumento ou o índice forem inválidos | | +| Notas: | Esta função define o valor de um argumento de uma lista de argumentos variáveis. Quando o argumento é um array, o parâmetro index especifica o índice no array. | | +| Veja também | getarg, numargs | | + +| swapchars | | Troca bytes em uma célula | +| --------- | -------------------------------------------------------------------------------------------------- | ----------------------------------: | +| Sintaxe | swapchars(c) | | +| | c | O valor para o qual trocar os bytes | +| Retorna | Um valor onde os bytes no parâmetro "c" são trocados (o byte mais baixo se torna o byte mais alto) | | + +| tolower | | Converte um caractere para minúscula | +| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------: | +| Sintaxe | tolower(c) | | +| | c | O caractere a converter para minúscula. | +| Retorna | A variante maiúscula do caractere de entrada, se existir, ou o código de caractere inalterado de "c" se a letra "c" não tiver equivalente minúsculo. | | +| Notas: | O suporte para caracteres acentuados é dependente da plataforma | | +| Veja também | toupper | | + +| toupper | | Converte um caractere para maiúscula | +| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------: | +| Sintaxe | toupper(c) | | +| | c | O caractere a converter para maiúscula. | +| Retorna | A variante minúscula do caractere de entrada, se existir, ou o código de caractere inalterado de "c" se a letra "c" não tiver equivalente maiúsculo. | | +| Notas: | O suporte para caracteres acentuados é dependente da plataforma | | +| Veja também | tolower | | --- diff --git a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/12-Assorted-tips.md b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/12-Assorted-tips.md index 40b517137d0..2b169e6f38c 100644 --- a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/12-Assorted-tips.md +++ b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/12-Assorted-tips.md @@ -174,6 +174,7 @@ fibonacci(n) ``` Listagem: fibonacci — função iterativa + ```c /* Calcular um número de Fibonacci pela iteração */ fibonacci(n) @@ -207,6 +208,7 @@ padrão, a primeira constante enum tem o valor zero. Você pode usar valores enu para criar matrizes "nomeados", como a sugestão do exemplo abaixo. Listagem: definições de constantes de cor + ```c enum color { @@ -257,6 +259,7 @@ As linhas abaixo são um exemplo simples de como fazer o loop por todos os carac em uma string empacotada. Listagem: comentário acima da função packedstring + ```c /* Função que conta os caracteres 'e' em uma string empacotada */ packedstring(string{}) @@ -273,17 +276,17 @@ packedstring(string{}) Os formatadores de saída printf e strformat foram baseados na função printf da linguagem de programação C. PAWN suporta os seguintes formatadores: -| Formatador | Significado | -| ---------- | -------------------------------------------------------------------------------------------------------------------------- | -| **%b** | número na base binária | -| **%c** | caractere | -| **%d** | número na base decimal (e sinalizado) | -| **%f** | número de ponto flutuante | -| **%q** | número de ponto fixo | -| **%r** | número racional em notação de fração ("1/4" em vez de "0.25") | -| **%s** | string | -| **%x** | número na base hexadecimal | -| **%%** | literal `%` | +| Formatador | Significado | +| ---------- | ------------------------------------------------------------- | +| **%b** | número na base binária | +| **%c** | caractere | +| **%d** | número na base decimal (e sinalizado) | +| **%f** | número de ponto flutuante | +| **%q** | número de ponto fixo | +| **%r** | número racional em notação de fração ("1/4" em vez de "0.25") | +| **%s** | string | +| **%x** | número na base hexadecimal | +| **%%** | literal `%` | O formatador %f está disponível apenas se a implementação incluir suporte a ponto flutuante. Observe que %f apenas formata o número; não converte @@ -307,13 +310,12 @@ de fração para entrada de constantes de ponto fixo ou ponto flutuante em PAWN. O ponto de interrogação (?) em uma string de formato dispara uma invocação automática de um prompt na saída. Por exemplo: Listagem: formatador de consulta + ```c new value getvalue(value, "?Valor da chave = ") ``` - - O caractere "?" na instrução também exibe um caractere de prompt "?", após o texto "Valor da chave = ". @@ -325,6 +327,7 @@ o tag. Por exemplo, para ver a diferença entre horas e minutos, você pode defi as tags como: Listagem: tag fraco + ```c new hours:h = 3 new minutes:m = 58 @@ -340,6 +343,7 @@ válidos (mais adiante). Você pode usar uma variável com uma tag forte apenas com a mesma tag é esperada. Veja as páginas 68 e 78 para mais informações sobre tags. Listagem: tag forte + ```c enum Boolean: /* o nome de enum da diretiva enum é uma tag "forte" */ { @@ -355,6 +359,7 @@ Se você usasse IsPositive na instrução condicional como abaixo (onde variável "n" é um inteiro normal) Listagem: usando uma função com tag forte como condição (com bug) + ```c if (IsPositive(n)) // ... @@ -392,6 +397,7 @@ runaway scripts — um script que vai além do seu ciclo de vida aceitável. Den A função callback, abaixo, verifica o nível de recursão. Se o nível de recursão for zero, é uma "função de nível superior" que foi chamada diretamente ou indiretamente pela função callback anterior executada. A função então lembra a hora em que foi chamada. Funções de nível não superior são aquelas que são funções de callback aninhadas. Para elas, a função apenas verifica se o script atingiu outro "marco" de chamada e verifica a diferença de tempo com o momento em que a primeira função de callback foi ativada. Listagem: abort.p + ```c @receita(time, const heession_id[], count) check_recursion_level(time) @@ -470,6 +476,7 @@ memória de forma assíncrona e independente do script PAWN. Quando a aquisiçã concluída, a função IsTimeReady retorna true e os dados no array estarão válidos. Listagem: obter tempo de maneira assíncrona + ```c #pragma dynamic 16 @@ -500,6 +507,7 @@ os dados são consultados em uma chamada de função explícita, retornar os dad de referência é tão válido quanto via variável global. Listagem: obter tempo com poll + ```c GetTimePoll(time[]) { @@ -521,6 +529,7 @@ A função printf é uma função de propósito geral com uma lista de parâmetr Se a implementação precisar economizar memória — em outras palavras, se você precisar de um executável menor na ROM — você pode definir sua própria funções nativas para casos especiais. Por exemplo, em vez de usar printf para exibir uma mensagem de depuração como a linha acima, você pode usar: Listagem: funções alternativas para printf + ```c #define dbgstring(%1) printf("%s", %1) #define dbgvalue(%1) printf("%d", %1) @@ -528,13 +537,13 @@ Listagem: funções alternativas para printf ## PAWN contra a escassez de memória -Comparado a soluções puramente baseadas em hardware, a memória de código de um sistema em +Comparado a soluções puramente baseadas em hardware, a memória de código de um sistema em PAWN normalmente será maior. Por um lado, você executa muitas implementações de código usando PAWN que executam a funcionalidade, mas não estariam lá em um solução por hardware (hardware sozinho implementa diretamente a funcionalidade). Por outro lado, você tem o overhead do próprio sistema de execução de bytecode — a "Máquina Abstrata". - + Os requisitos de memória da máquina abstrata são: - O código (ROM) da própria máquina abstrata. A máquina abstrata mais simples, incluindo uma interface de impressão para depuração, uma interface para gerenciamento de @@ -556,6 +565,7 @@ Ao definir uma macro LIMIT, certifique-se de não adicionar um ponto e vírgula. Uma definição como: Listagem: armadilha potencial — ponto e vírgula após uma substitução de macro #define + ```c #define LIMIT 10; ``` @@ -571,6 +581,7 @@ não se estendem através de linhas e não atravessam strings. Portanto, se voc a macro abaixo: Listagem: armadilha potencial — correspondência de padrão em uma macro #define + ```c #define a(%1) abc(%1, 2) ``` diff --git a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/13-Appendices.md b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/13-Appendices.md index 7fed0da7391..b482679aee9 100644 --- a/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/13-Appendices.md +++ b/frontend/i18n/pt-BR/docusaurus-plugin-content-docs/current/scripting/language/reference/13-Appendices.md @@ -6,171 +6,171 @@ Quando o compilador encontra um erro em um arquivo, ele emite uma mensagem e, dependendo da classe do erro, ele define uma linha de retorno de erro correspondente. Existem três classes de erros: -| Erro | Significado | -| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **Errors (Erros)** | Erros de sintaxe ou semânticos impossíveis de compilar; o compilador pula linhas de código até poder continuar a compilação; então, nenhum código de saída é gerado. | +| Erro | Significado | +| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **Errors (Erros)** | Erros de sintaxe ou semânticos impossíveis de compilar; o compilador pula linhas de código até poder continuar a compilação; então, nenhum código de saída é gerado. | | **Fatal Errors (Erros fatais)** | Situações de erro que forçam o compilador a abortar imediatamente. Estes erros têm o risco de corromper dados no computador se não forem tratados. Estes erros também ocorrem por estouros de memória ou interrupção de E/S durante a compilação; Erros fatais não estão em todas as situações relacionados ao erro no código-fonte | -| **Warnings (Avisos)** | Possíveis problemas semânticos ou não portabilidades na semântica. O código é provavelmente suspeito em termos de implementação. Avisos podem algumas vezes ser causados por extensões específicas do compilador que são habilitadas | +| **Warnings (Avisos)** | Possíveis problemas semânticos ou não portabilidades na semântica. O código é provavelmente suspeito em termos de implementação. Avisos podem algumas vezes ser causados por extensões específicas do compilador que são habilitadas | ### Erros -| ID | Texto / Descrição | -| --- | --------------------------------------------------------------------------------------------------------------------------------------------- | -| 001 | expected token: "token", but found "token" - token esper "token", mas encontrado "token". Um símbolo necessário está faltando. | -| 002 | only a single statement (or expression) can follow each "case" - apenas uma única instrução pode seguir cada "case". Cada rótulo de case deve ser seguido por uma instrução; você pode usar {} bloco composto. | -| 003 | declaration of a local variable must appear in a compound block - uma declaração de variável local deve aparecer dentro de um bloco composto {}. | -| 004 | function "name" is not implemented - função "nome" não está implementada. Há uma declaração forward, mas a função não existe. | -| 005 | function may not have arguments - função não pode ter argumentos. Função main ou um callback de evento não pode ter argumentos. | -| 006 | must be assigned to an array - o operando deve ser um array (ou seja, deve ser assinalado a um array). | -| 007 | operator cannot be redefined - o operador não pode ser redefinido. Você não pode fornecer uma definição alternativa para alguns operadores. | -| 008 | must be a constant expression; assumed zero - deve ser uma expressão constante; assumido zero. Um erro de sintaxe esperado para uma expressão constante. | -| 009 | invalid array size (negative, zero or out of bounds) - tamanho de array inválido (negativo, zero ou fora dos limites). | -| 010 | illegal function or declaration - função ou declaração ilegal. Uma sintaxe de função ou declaração de variável estava incorreta. | -| 011 | invalid outside functions - inválido fora de funções. Uma instrução ou expressão deve estar dentro da definição de uma função. | -| 012 | invalid function call, not a valid address - chamada de função inválida, não um endereço válido. A função é apenas declarada, mas nunca definida. | -| 013 | no entry point (no public functions) - sem ponto de entrada (nenhuma função pública). O arquivo contém apenas código inativo ou apenas constantes. | -| 014 | invalid statement; not in switch - instrução inválida; não está em switch. Os rótulos "case" e "default" existem apenas nas instruções switch. | -| 015 | "default" must be the last clause in switch statement - "default" deve ser a última cláusula em uma instrução switch. | -| 016 | multiple defaults in "switch" - vários defaults em "switch". Apenas uma cláusula default é permitida. | -| 017 | undefined symbol string - símbolo indefinido. Uma string literal está mal formada. | -| 018 | initialization data exceeds declared size - dados de inicialização excedem o tamanho declarado. Mais dados foi fornecido na inicialização do que cabe na variável/array. | -| 019 | not a label: "name" - não é um rótulo: "nome". goto só permite um rótulo de destino. | -| 020 | invalid symbol name "name" - nome de símbolo inválido "nome". O nome de variável contém caracteres inválidos. | -| 021 | symbol already defined: "name" - símbolo já definido: "nome". O símbolo já foi definido anteriormente. | -| 022 | must be lvalue (non-constant) - deve ser lvalue (não constante).A expressão deve ser uma variável que possa ser atribuída, não uma constante. | -| 023 | array assignment must be simple assignment - a atribuição de array deve ser uma atribuição simples (sem +=, etc). | -| 024 | "break" or "continue" is out of context - "break" ou "continue" está fora de contexto. Essas instruções são válidas apenas dentro de um loop. | -| 025 | function heading differs from prototype - cabeçalho de função difere do protótipo. A definição da função e sua declaração forward não combinam. | -| 026 | expected token: "number" - token esperado numérico. Um número literal era esperado na posição. | -| 027 | invalid character constant - constante de caractere inválida. A constante de caractere tem comprimento incorreto. | -| 028 | invalid subscript (not an array or too many subscripts): "name" - subscrição inválida (não é um array ou muitas subscrições): "nome". | -| 029 | invalid expression, assumed zero - expressão inválida, assumido zero. Sintaxe errada na expressão. | -| 030 | compound statement not closed at the end of file (started at line number) - instrução composta não fechada no final do arquivo (iniciada na linha número). | -| 031 | unknown directive - diretiva desconhecida. O comando #pragma não é reconhecido. | -| 032 | array index out of bounds (variable "name") - índice de array fora dos limites (variável "nome"). | -| 033 | array must be indexed (variable "name") - array deve ser indexado (variável "nome"). Você tentou usar um array sem um índice. | -| 034 | argument does not have a default value (argument index) - argumento não tem um valor padrão (índice do argumento). | -| 035 | argument type mismatch (argument index) - incompatibilidade de tipo de argumento (índice do argumento). A expressão não combina com o tipo esperado. | -| 036 | empty statement - instrução vazia. O programa contém instruções vazias inesperadas/desnecessárias. | -| 037 | invalid string (possibly non-terminated string) - string inválida (possivelmente string não terminada). | -| 038 | extra characters on line - caracteres extras na linha. Existem caracteres extras após uma instrução. | -| 039 | constant symbol has no size - símbolo constante sem tamanho. O operador sizeof não funciona em constantes numéricas. | -| 040 | duplicate "case" label (value number) - rótulo "case" duplicado (valor número). O mesmo valor já está associado a outro label case. | -| 041 | invalid ellipsis, array size is not known - reticências inválido, tamanho do array desconhecido. | -| 042 | invalid combination of class specifiers - combinação inválida de especificadores de classe. Combinação de static e public não é permitida. | -| 043 | character constant exceeds range for packed string - constante de caractere excede intervalo para string empacotada. | -| 044 | positional parameters must precede all named parameters - parâmetros posicionais devem preceder todos os parâmetros nomeados. | -| 045 | too many function arguments - muitos argumentos de função. Mais argumentos fornecidos do que a função declara. | -| 046 | unknown array size (variable "name") - tamanho desconhecido de array. A dimensão do array não está definida. | -| 047 | array sizes do not match, or destination array is too small - tamanhos de arrays não coincidem, ou array de destino é muito pequeno. | -| 048 | array dimensions do not match - dimensões de arrays não coincidem. O número de dimensões difere. | -| 049 | invalid line continuation - continuação de linha inválida. Código após \ no final de uma linha. | -| 050 | invalid range - intervalo inválido. Ordem errada de valores (mínimo > máximo). | -| 051 | invalid subscript, use "[]" operators on major dimensions - subscrição inválida, use operadores "[]" em dimensões maiores. | -| 052 | multi-dimensional arrays must be fully initialized - arrays multidimensionais devem ser totalmente inicializados. | -| 053 | exceeding maximum number of dimensions - excedendo número máximo de dimensões. Máximo de 3 dimensões (configurável). | -| 054 | unmatched closing brace (" }") - chave de fechamento não correspondente ("}"). Há mais chaves de fechamento que de abertura. | -| 055 | start of function body without function header - início do corpo da função sem cabeçalho de função. | -| 056 | arrays, local variables and function arguments cannot be public (variable "name") - arrays, variáveis locais e argumentos de função não podem ser públicos. | -| 057 | unfinished expression before compiler directive - expressão inacabada antes da diretiva do compilador. Faltou ";" na instrução anterior. | -| 058 | duplicate argument; same argument is passed twice - argumento duplicado; o mesmo argumento é passado duas vezes. | -| 059 | function argument may not have a default value (variable "name") - argumento de função não pode ter valor padrão quando argumento de referência é variável array. | -| 060 | multiple "#else" directives between "#if ... #endif" - múltiplas diretivas "#else" entre "#if ... #endif". | -| 061 | "#elseif" directive follows an "#else" directive - diretiva "#elseif" segue diretiva "#else". | -| 062 | number of operands does not fit the operator - número de operandos não se encaixa no operador. | -| 063 | function result tag of operator "name" must be "name" - tag de resultado de função do operador deve ser "nome". | -| 064 | cannot change predefined operators - não é possível alterar operadores predefinidos. | -| 065 | function argument may only have a single tag (argument number) - argumento de função só pode ter uma única tag (número do argumento). | -| 066 | function argument may not be a reference argument or an array (argument "name") - argumento de função não pode ser referência nem array (argumento "nome"). | -| 067 | variable cannot be both a reference and an array (variable "name") - variável não pode ser tanto referência quanto array (variável "nome"). | -| 068 | invalid rational number precision in #pragma - precisão de número racional inválida em #pragma. | -| 069 | rational number format already defined - formato de número racional já definido. | -| 070 | rational number support was not enabled - suporte a números racionais não foi habilitado. | -| 071 | user-defined operator must be declared before use (function "name") - operador definido pelo usuário deve ser declarado antes do uso (função "nome"). | -| 072 | "sizeof" operator is invalid on "function" symbols - operador "sizeof" é inválido em símbolos de "função". | -| 073 | function argument must be an array (argument "name") - argumento de função deve ser um array (argumento "nome"). | -| 074 | #define pattern must start with an alphabetic character - padrão #define deve começar com um caractere alfabético. | -| 075 | input line too long (after substitutions) - linha de entrada muito longa (após substituições). | -| 076 | syntax error in the expression, or invalid function call - erro de sintaxe na expressão, ou chamada de função inválida. | -| 077 | malformed UTF-8 encoding, or corrupted file: filename - codificação UTF-8 malformada, ou arquivo corrompido: nome do arquivo. | -| 078 | function uses both "return" and "return \" - função usa tanto "return" quanto "return \". | -| 079 | inconsistent return types (array & non-array) - tipos de retorno inconsistentes (array e não-array). | -| 080 | unknown symbol, or not a constant symbol (symbol "name") - símbolo desconhecido, ou não é um símbolo constante (símbolo "nome"). | -| 081 | cannot take a tag as a default value for an indexed array parameter (symbol "name") - não é possível usar tag como valor padrão para parâmetro de array indexado (símbolo "nome"). | -| 082 | user-defined operators and native functions may not have states - operadores definidos pelo usuário e funções nativas não podem ter estados. | -| 083 | a function or variable may only belong to a single automaton (symbol "name") - uma função ou variável só pode pertencer a um único autômato (símbolo "nome"). | -| 084 | state conflict: one of the states is already assigned to another implementation (symbol "name") - conflito de estado: um dos estados já está atribuído a outra implementação (símbolo "nome"). | -| 085 | no states are defined for symbol "name" - nenhum estado está definido para o símbolo "nome". | -| 086 | unknown automaton "name" - autômato desconhecido "nome". | -| 087 | unknown state "name" for automaton "name" - estado desconhecido "nome" para autômato "nome". | -| 088 | public variables and local variables may not have states (symbol "name") - variáveis públicas e locais não podem ter estados (símbolo "nome"). | -| 089 | state variables may not be initialized (symbol "name") - variáveis de estado não podem ser inicializadas (símbolo "nome"). | -| 090 | public functions may not return arrays (symbol "name") - funções públicas não podem retornar arrays (símbolo "nome"). | -| 091 | ambiguous constant; tag override is required (symbol "name") - constante ambígua; substituição de tag é necessária (símbolo "nome"). | +| ID | Texto / Descrição | +| --- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 001 | expected token: "token", but found "token" - token esper "token", mas encontrado "token". Um símbolo necessário está faltando. | +| 002 | only a single statement (or expression) can follow each "case" - apenas uma única instrução pode seguir cada "case". Cada rótulo de case deve ser seguido por uma instrução; você pode usar {} bloco composto. | +| 003 | declaration of a local variable must appear in a compound block - uma declaração de variável local deve aparecer dentro de um bloco composto {}. | +| 004 | function "name" is not implemented - função "nome" não está implementada. Há uma declaração forward, mas a função não existe. | +| 005 | function may not have arguments - função não pode ter argumentos. Função main ou um callback de evento não pode ter argumentos. | +| 006 | must be assigned to an array - o operando deve ser um array (ou seja, deve ser assinalado a um array). | +| 007 | operator cannot be redefined - o operador não pode ser redefinido. Você não pode fornecer uma definição alternativa para alguns operadores. | +| 008 | must be a constant expression; assumed zero - deve ser uma expressão constante; assumido zero. Um erro de sintaxe esperado para uma expressão constante. | +| 009 | invalid array size (negative, zero or out of bounds) - tamanho de array inválido (negativo, zero ou fora dos limites). | +| 010 | illegal function or declaration - função ou declaração ilegal. Uma sintaxe de função ou declaração de variável estava incorreta. | +| 011 | invalid outside functions - inválido fora de funções. Uma instrução ou expressão deve estar dentro da definição de uma função. | +| 012 | invalid function call, not a valid address - chamada de função inválida, não um endereço válido. A função é apenas declarada, mas nunca definida. | +| 013 | no entry point (no public functions) - sem ponto de entrada (nenhuma função pública). O arquivo contém apenas código inativo ou apenas constantes. | +| 014 | invalid statement; not in switch - instrução inválida; não está em switch. Os rótulos "case" e "default" existem apenas nas instruções switch. | +| 015 | "default" must be the last clause in switch statement - "default" deve ser a última cláusula em uma instrução switch. | +| 016 | multiple defaults in "switch" - vários defaults em "switch". Apenas uma cláusula default é permitida. | +| 017 | undefined symbol string - símbolo indefinido. Uma string literal está mal formada. | +| 018 | initialization data exceeds declared size - dados de inicialização excedem o tamanho declarado. Mais dados foi fornecido na inicialização do que cabe na variável/array. | +| 019 | not a label: "name" - não é um rótulo: "nome". goto só permite um rótulo de destino. | +| 020 | invalid symbol name "name" - nome de símbolo inválido "nome". O nome de variável contém caracteres inválidos. | +| 021 | symbol already defined: "name" - símbolo já definido: "nome". O símbolo já foi definido anteriormente. | +| 022 | must be lvalue (non-constant) - deve ser lvalue (não constante).A expressão deve ser uma variável que possa ser atribuída, não uma constante. | +| 023 | array assignment must be simple assignment - a atribuição de array deve ser uma atribuição simples (sem +=, etc). | +| 024 | "break" or "continue" is out of context - "break" ou "continue" está fora de contexto. Essas instruções são válidas apenas dentro de um loop. | +| 025 | function heading differs from prototype - cabeçalho de função difere do protótipo. A definição da função e sua declaração forward não combinam. | +| 026 | expected token: "number" - token esperado numérico. Um número literal era esperado na posição. | +| 027 | invalid character constant - constante de caractere inválida. A constante de caractere tem comprimento incorreto. | +| 028 | invalid subscript (not an array or too many subscripts): "name" - subscrição inválida (não é um array ou muitas subscrições): "nome". | +| 029 | invalid expression, assumed zero - expressão inválida, assumido zero. Sintaxe errada na expressão. | +| 030 | compound statement not closed at the end of file (started at line number) - instrução composta não fechada no final do arquivo (iniciada na linha número). | +| 031 | unknown directive - diretiva desconhecida. O comando #pragma não é reconhecido. | +| 032 | array index out of bounds (variable "name") - índice de array fora dos limites (variável "nome"). | +| 033 | array must be indexed (variable "name") - array deve ser indexado (variável "nome"). Você tentou usar um array sem um índice. | +| 034 | argument does not have a default value (argument index) - argumento não tem um valor padrão (índice do argumento). | +| 035 | argument type mismatch (argument index) - incompatibilidade de tipo de argumento (índice do argumento). A expressão não combina com o tipo esperado. | +| 036 | empty statement - instrução vazia. O programa contém instruções vazias inesperadas/desnecessárias. | +| 037 | invalid string (possibly non-terminated string) - string inválida (possivelmente string não terminada). | +| 038 | extra characters on line - caracteres extras na linha. Existem caracteres extras após uma instrução. | +| 039 | constant symbol has no size - símbolo constante sem tamanho. O operador sizeof não funciona em constantes numéricas. | +| 040 | duplicate "case" label (value number) - rótulo "case" duplicado (valor número). O mesmo valor já está associado a outro label case. | +| 041 | invalid ellipsis, array size is not known - reticências inválido, tamanho do array desconhecido. | +| 042 | invalid combination of class specifiers - combinação inválida de especificadores de classe. Combinação de static e public não é permitida. | +| 043 | character constant exceeds range for packed string - constante de caractere excede intervalo para string empacotada. | +| 044 | positional parameters must precede all named parameters - parâmetros posicionais devem preceder todos os parâmetros nomeados. | +| 045 | too many function arguments - muitos argumentos de função. Mais argumentos fornecidos do que a função declara. | +| 046 | unknown array size (variable "name") - tamanho desconhecido de array. A dimensão do array não está definida. | +| 047 | array sizes do not match, or destination array is too small - tamanhos de arrays não coincidem, ou array de destino é muito pequeno. | +| 048 | array dimensions do not match - dimensões de arrays não coincidem. O número de dimensões difere. | +| 049 | invalid line continuation - continuação de linha inválida. Código após \ no final de uma linha. | +| 050 | invalid range - intervalo inválido. Ordem errada de valores (mínimo > máximo). | +| 051 | invalid subscript, use "[]" operators on major dimensions - subscrição inválida, use operadores "[]" em dimensões maiores. | +| 052 | multi-dimensional arrays must be fully initialized - arrays multidimensionais devem ser totalmente inicializados. | +| 053 | exceeding maximum number of dimensions - excedendo número máximo de dimensões. Máximo de 3 dimensões (configurável). | +| 054 | unmatched closing brace (" }") - chave de fechamento não correspondente ("}"). Há mais chaves de fechamento que de abertura. | +| 055 | start of function body without function header - início do corpo da função sem cabeçalho de função. | +| 056 | arrays, local variables and function arguments cannot be public (variable "name") - arrays, variáveis locais e argumentos de função não podem ser públicos. | +| 057 | unfinished expression before compiler directive - expressão inacabada antes da diretiva do compilador. Faltou ";" na instrução anterior. | +| 058 | duplicate argument; same argument is passed twice - argumento duplicado; o mesmo argumento é passado duas vezes. | +| 059 | function argument may not have a default value (variable "name") - argumento de função não pode ter valor padrão quando argumento de referência é variável array. | +| 060 | multiple "#else" directives between "#if ... #endif" - múltiplas diretivas "#else" entre "#if ... #endif". | +| 061 | "#elseif" directive follows an "#else" directive - diretiva "#elseif" segue diretiva "#else". | +| 062 | number of operands does not fit the operator - número de operandos não se encaixa no operador. | +| 063 | function result tag of operator "name" must be "name" - tag de resultado de função do operador deve ser "nome". | +| 064 | cannot change predefined operators - não é possível alterar operadores predefinidos. | +| 065 | function argument may only have a single tag (argument number) - argumento de função só pode ter uma única tag (número do argumento). | +| 066 | function argument may not be a reference argument or an array (argument "name") - argumento de função não pode ser referência nem array (argumento "nome"). | +| 067 | variable cannot be both a reference and an array (variable "name") - variável não pode ser tanto referência quanto array (variável "nome"). | +| 068 | invalid rational number precision in #pragma - precisão de número racional inválida em #pragma. | +| 069 | rational number format already defined - formato de número racional já definido. | +| 070 | rational number support was not enabled - suporte a números racionais não foi habilitado. | +| 071 | user-defined operator must be declared before use (function "name") - operador definido pelo usuário deve ser declarado antes do uso (função "nome"). | +| 072 | "sizeof" operator is invalid on "function" symbols - operador "sizeof" é inválido em símbolos de "função". | +| 073 | function argument must be an array (argument "name") - argumento de função deve ser um array (argumento "nome"). | +| 074 | #define pattern must start with an alphabetic character - padrão #define deve começar com um caractere alfabético. | +| 075 | input line too long (after substitutions) - linha de entrada muito longa (após substituições). | +| 076 | syntax error in the expression, or invalid function call - erro de sintaxe na expressão, ou chamada de função inválida. | +| 077 | malformed UTF-8 encoding, or corrupted file: filename - codificação UTF-8 malformada, ou arquivo corrompido: nome do arquivo. | +| 078 | function uses both "return" and "return \" - função usa tanto "return" quanto "return \". | +| 079 | inconsistent return types (array & non-array) - tipos de retorno inconsistentes (array e não-array). | +| 080 | unknown symbol, or not a constant symbol (symbol "name") - símbolo desconhecido, ou não é um símbolo constante (símbolo "nome"). | +| 081 | cannot take a tag as a default value for an indexed array parameter (symbol "name") - não é possível usar tag como valor padrão para parâmetro de array indexado (símbolo "nome"). | +| 082 | user-defined operators and native functions may not have states - operadores definidos pelo usuário e funções nativas não podem ter estados. | +| 083 | a function or variable may only belong to a single automaton (symbol "name") - uma função ou variável só pode pertencer a um único autômato (símbolo "nome"). | +| 084 | state conflict: one of the states is already assigned to another implementation (symbol "name") - conflito de estado: um dos estados já está atribuído a outra implementação (símbolo "nome"). | +| 085 | no states are defined for symbol "name" - nenhum estado está definido para o símbolo "nome". | +| 086 | unknown automaton "name" - autômato desconhecido "nome". | +| 087 | unknown state "name" for automaton "name" - estado desconhecido "nome" para autômato "nome". | +| 088 | public variables and local variables may not have states (symbol "name") - variáveis públicas e locais não podem ter estados (símbolo "nome"). | +| 089 | state variables may not be initialized (symbol "name") - variáveis de estado não podem ser inicializadas (símbolo "nome"). | +| 090 | public functions may not return arrays (symbol "name") - funções públicas não podem retornar arrays (símbolo "nome"). | +| 091 | ambiguous constant; tag override is required (symbol "name") - constante ambígua; substituição de tag é necessária (símbolo "nome"). | ### Erros Fatais -| ID | Texto / Descrição | -| --- | ------------------------------------------------------------------------------------ | -| 100 | cannot read from file: "filename" - não é possível ler do arquivo: "nome do arquivo". | -| 101 | cannot write to file: "filename" - não é possível escrever no arquivo: "nome do arquivo". | -| 102 | table overflow: "table name" - estouro de tabela: "nome da tabela". | -| 103 | insufficient memory - memória insuficiente. | -| 104 | invalid assembler instruction "instruction" - instrução de montador inválida. | -| 105 | numeric overflow, exceeding capacity - estouro numérico, excedendo capacidade. | +| ID | Texto / Descrição | +| --- | --------------------------------------------------------------------------------------------------------------------------------------- | +| 100 | cannot read from file: "filename" - não é possível ler do arquivo: "nome do arquivo". | +| 101 | cannot write to file: "filename" - não é possível escrever no arquivo: "nome do arquivo". | +| 102 | table overflow: "table name" - estouro de tabela: "nome da tabela". | +| 103 | insufficient memory - memória insuficiente. | +| 104 | invalid assembler instruction "instruction" - instrução de montador inválida. | +| 105 | numeric overflow, exceeding capacity - estouro numérico, excedendo capacidade. | | 106 | compiled script exceeds the maximum memory size (number bytes) - script compilado excede o tamanho máximo de memória (número de bytes). | -| 107 | too many error/warning messages on one line - muitas mensagens de erro/aviso em uma linha. | -| 108 | codepage mapping file not found - arquivo de mapeamento de página de código não encontrado. | -| 109 | invalid path: "path" - caminho inválido: "caminho". | -| 110 | assertion failed: expression - asserção falhou: expressão. | -| 111 | user error: message - erro do usuário: mensagem. Gerada por #error ou #assert. | +| 107 | too many error/warning messages on one line - muitas mensagens de erro/aviso em uma linha. | +| 108 | codepage mapping file not found - arquivo de mapeamento de página de código não encontrado. | +| 109 | invalid path: "path" - caminho inválido: "caminho". | +| 110 | assertion failed: expression - asserção falhou: expressão. | +| 111 | user error: message - erro do usuário: mensagem. Gerada por #error ou #assert. | ### Avisos -| ID | Texto / Descrição | -| --- | ----------------------------------------------------------------------------------------------------------------------------- | -| 200 | symbol "name" is truncated to number characters - símbolo "nome" foi truncado para número de caracteres. | -| 201 | redefinition of constant/macro (symbol "name") - redefinição de constante/macro (símbolo "nome"). | -| 202 | number of arguments does not match definition - número de argumentos não corresponde à definição. | -| 203 | symbol is never used: "name" - símbolo nunca é usado: "nome". | -| 204 | symbol is assigned a value that is never used: "name" - símbolo tem um valor atribuído que nunca é usado: "nome". | -| 205 | redundant code: constant expression is zero - código redundante: expressão constante é zero. | -| 206 | redundant test: constant expression is non-zero - teste redundante: expressão constante é não-zero. | -| 207 | unknown "#pragma" - "#pragma" desconhecido. | +| ID | Texto / Descrição | +| --- | ---------------------------------------------------------------------------------------------------------------------------------------------- | +| 200 | symbol "name" is truncated to number characters - símbolo "nome" foi truncado para número de caracteres. | +| 201 | redefinition of constant/macro (symbol "name") - redefinição de constante/macro (símbolo "nome"). | +| 202 | number of arguments does not match definition - número de argumentos não corresponde à definição. | +| 203 | symbol is never used: "name" - símbolo nunca é usado: "nome". | +| 204 | symbol is assigned a value that is never used: "name" - símbolo tem um valor atribuído que nunca é usado: "nome". | +| 205 | redundant code: constant expression is zero - código redundante: expressão constante é zero. | +| 206 | redundant test: constant expression is non-zero - teste redundante: expressão constante é não-zero. | +| 207 | unknown "#pragma" - "#pragma" desconhecido. | | 208 | function with tag result used before definition, forcing reparse - função com resultado com tag usada antes da definição., forçando reparsear. | -| 209 | function "name" should return a value - função "nome" deveria retornar um valor. | -| 210 | possible use of symbol before initialization: "name" - possível uso de símbolo antes da inicialização: "nome". | -| 211 | possibly unintended assignment - possível atribuição não intencional. "=" vs "==". | -| 212 | possibly unintended bitwise operation - operação bitwise possivelmente não intencional. "&" vs "&&". | -| 213 | tag mismatch - incompatibilidade de tag. Expressões têm tags diferentes. | -| 214 | possibly a "const" array argument was intended: "name" - possivelmente um argumento de array "const" era pretendido: "nome". | -| 215 | expression has no effect - a expressão não tem efeito. O resultado é descartado. | -| 216 | nested comment - comentário aninhado. Comentários que abrem dentro de outros comentários. | -| 217 | loose indentation - indentação inconsistente. Código mal formatado detectado. | -| 218 | old style prototypes used with optional semicolum - protótipos de estilo antigo utilizaram ponto e vírgula opcional. | -| 219 | local variable "name" shadows a variable at a preceding level - variável local "nome" obscureceu uma variável de um nível anterior. | -| 220 | expression with tag override must appear between parentheses - expressão com substituição de tag deve aparecer entre parênteses. | -| 221 | label name "name" shadows tag name - nome do rótulo "nome" obscurece nome de tag. | -| 222 | number of digits exceeds rational number precision - número de dígitos excede a precisão do número racional. | -| 223 | redundant "sizeof": argument size is always 1 (symbol "name") - "sizeof" redundante: tamanho do argumento é sempre 1 (símbolo "nome"). | -| 224 | indeterminate array size in "sizeof" expression (symbol "name") - tamanho de array indeterminado em expressão "sizeof" (símbolo "nome"). | -| 225 | unreachable code - código inalcançável. O código após return, break, continue ou goto não será executado. | -| 226 | a]variable is assigned to itself (symbol "name") - variável é atribuída a si mesma (símbolo "nome"). | -| 227 | more initializers than enum fields - mais inicializadores que campos do enum. | -| 228 | length of initializer exceeds size of the enum field - comprimento do inicializador excede o tamanho do campo do enum. | -| 229 | index tag mismatch (symbol "name") - incompatibilidade de tag de índice (símbolo "nome"). | -| 230 | no implementation for state "name" in function "name", no fall-back - sem implementação para estado "nome" na função "nome", sem fallback. | -| 231 | state specification on forward declaration is ignored - especificação de estado na declaração forward é ignorada. | -| 232 | output file is written, but with compact encoding disabled - arquivo de saída é escrito, mas com codificação compacta desabilitada. | -| 233 | state variable "name" shadows a global variable - variável de estado "nome" obscurece uma variável global. | -| 234 | function is deprecated (symbol "name") - função está obsoleta (símbolo "nome"). Use a alternativa sugerida. | -| 235 | public function lacks forward declaration (symbol "name") - função pública não tem declaração forward (símbolo "nome"). | -| 236 | unknown parameter in substitution (incorrect #define pattern) - parâmetro desconhecido na substituição (padrão #define incorreto). | -| 237 | recursive function (symbol "name") - função recursiva (símbolo "nome"). Detectada inadvertidamente. | -| 238 | mixing of string formats in a concatenation - mistura de formatos de string em uma concatenação. | -| 239 | literal array/string passed to a non-const parameter - array/string literal passado para um parâmetro não const. | -| 240 | reserved value for tag field (symbol "name") - valor reservado para campo de tag (símbolo "nome"). | -| 241 | A tag alters the value of a constant - uma tag altera o valor de uma constante. | +| 209 | function "name" should return a value - função "nome" deveria retornar um valor. | +| 210 | possible use of symbol before initialization: "name" - possível uso de símbolo antes da inicialização: "nome". | +| 211 | possibly unintended assignment - possível atribuição não intencional. "=" vs "==". | +| 212 | possibly unintended bitwise operation - operação bitwise possivelmente não intencional. "&" vs "&&". | +| 213 | tag mismatch - incompatibilidade de tag. Expressões têm tags diferentes. | +| 214 | possibly a "const" array argument was intended: "name" - possivelmente um argumento de array "const" era pretendido: "nome". | +| 215 | expression has no effect - a expressão não tem efeito. O resultado é descartado. | +| 216 | nested comment - comentário aninhado. Comentários que abrem dentro de outros comentários. | +| 217 | loose indentation - indentação inconsistente. Código mal formatado detectado. | +| 218 | old style prototypes used with optional semicolum - protótipos de estilo antigo utilizaram ponto e vírgula opcional. | +| 219 | local variable "name" shadows a variable at a preceding level - variável local "nome" obscureceu uma variável de um nível anterior. | +| 220 | expression with tag override must appear between parentheses - expressão com substituição de tag deve aparecer entre parênteses. | +| 221 | label name "name" shadows tag name - nome do rótulo "nome" obscurece nome de tag. | +| 222 | number of digits exceeds rational number precision - número de dígitos excede a precisão do número racional. | +| 223 | redundant "sizeof": argument size is always 1 (symbol "name") - "sizeof" redundante: tamanho do argumento é sempre 1 (símbolo "nome"). | +| 224 | indeterminate array size in "sizeof" expression (symbol "name") - tamanho de array indeterminado em expressão "sizeof" (símbolo "nome"). | +| 225 | unreachable code - código inalcançável. O código após return, break, continue ou goto não será executado. | +| 226 | a]variable is assigned to itself (symbol "name") - variável é atribuída a si mesma (símbolo "nome"). | +| 227 | more initializers than enum fields - mais inicializadores que campos do enum. | +| 228 | length of initializer exceeds size of the enum field - comprimento do inicializador excede o tamanho do campo do enum. | +| 229 | index tag mismatch (symbol "name") - incompatibilidade de tag de índice (símbolo "nome"). | +| 230 | no implementation for state "name" in function "name", no fall-back - sem implementação para estado "nome" na função "nome", sem fallback. | +| 231 | state specification on forward declaration is ignored - especificação de estado na declaração forward é ignorada. | +| 232 | output file is written, but with compact encoding disabled - arquivo de saída é escrito, mas com codificação compacta desabilitada. | +| 233 | state variable "name" shadows a global variable - variável de estado "nome" obscurece uma variável global. | +| 234 | function is deprecated (symbol "name") - função está obsoleta (símbolo "nome"). Use a alternativa sugerida. | +| 235 | public function lacks forward declaration (symbol "name") - função pública não tem declaração forward (símbolo "nome"). | +| 236 | unknown parameter in substitution (incorrect #define pattern) - parâmetro desconhecido na substituição (padrão #define incorreto). | +| 237 | recursive function (symbol "name") - função recursiva (símbolo "nome"). Detectada inadvertidamente. | +| 238 | mixing of string formats in a concatenation - mistura de formatos de string em uma concatenação. | +| 239 | literal array/string passed to a non-const parameter - array/string literal passado para um parâmetro não const. | +| 240 | reserved value for tag field (symbol "name") - valor reservado para campo de tag (símbolo "nome"). | +| 241 | A tag alters the value of a constant - uma tag altera o valor de uma constante. | --- @@ -187,37 +187,37 @@ As opções de linha de comando do compilador podem ser substituídas em parte p As opções de linha de comando são: -| Opção | Descrição | -| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **-a** | Apenas assemblador; gera um arquivo .asm que contém o pseudo-código gerado para a máquina abstrata do PAWN. Os "nomes de instrução" no arquivo gerado são realmente diretivas para a ferramenta _pawnasm_, que pode montar o arquivo pseudo-código de volta para binário. | -| **-C[+/-]** | Codificação compacta do binário, gerado ou não; sobrescreve a diretiva #pragma pack. Por padrão, a codificação compacta está habilitada. | -| **-cname** | Nome da página de código ou nome do arquivo; por exemplo -ciso-8859-1. Se o nome não corresponder a uma página de código conhecida, ele é interpretado como um nome de arquivo. | -| **-Dpath** | Diretório de trabalho do compilador, para a tabela de símbolos e quaisquer arquivos temporários. | -| **-d0** | Sem informação simbólica; desabilita a depuração. É impossível usar um depurador simbólico neste modo (mas depuração "printf-assembly" ainda é suportada). | -| **-d1** | Informação simbólica suficiente para rastrear números de linha e nomes de funções; este é o nível padrão de informação de depuração. | -| **-d2** | Informações simbólicas completas; mesma informação de depuração de d1, além de informações simbólicas locais e arrays de comprimento zero. | -| **-d3** | Informações simbólicas completas (como d2) E verificações de tempo de execução habilitadas. | -| **-e filename** | Redirecionar mensagens de erro para o arquivo especificado. | -| **-H value** | "window-handle" (identificador de janela) do ambiente de desenvolvimento integrado (IDE), para propósitos de notificação. O compilador enviará uma mensagem do Windows para a janela especificada quando terminar a compilação. | -| **-i path** | Caminho para arquivos include; múltiplas opções -i são permitidas. | -| **-l** | Criar arquivo de listagem; este é um arquivo de texto com a fonte, o bytecode e a data de endereço. | -| **-o filename** | Especifica nome (e caminho) para o arquivo de saída. | -| **-O level** | Nível de otimização: 0 = sem otimização; 1 = verificações de célula única, propagação de constantes e otimização peephole; mais altos = mais otimizações. | -| **-p filename** | Prefixo do nome do arquivo para o arquivo de saída. | -| **-r[name]** | Escrever relatório de referência cruzada no arquivo de teste (nome) ou em relação ao nome de entrada. | -| **-S value** | Tamanho do stack/heap em células. | -| **-s value** | Número de linhas antes de pular para primeira palavra (padrão = 0 = pular nenhuma linha). | -| **-t value** | TAB: número de caracteres de espaço por tabulação (usado pelo aviso de indentação frouxa). Por padrão, tabulações têm comprimento 8. | -| **-V value** | nível de verbosidade: 0 = silencioso, 1 = avisos normais, 2 = avisos. | -| **-v[+/-]** | habilita/desabilita avisos adicionais de status. | -| **-w number [+/-]** | Habilita/desabilita um aviso específico pelo número. Veja também #pragma warning. | -| **-X value** | Tamanho da máquina abstrata; se zero, haverá apenas verificações de tempo de execução. | -| **-XD value** | Tamanho do segmento de dados abstrato. | -| **-\\** | Usa "\\" em caminhos ao invés de "/". | -| **-^** | Usa "^" ao invés de "\\" como caractere de escape para strings. | -| **-;[+/-]** | Exigir ou não ponto e vírgula para terminar cada instrução. | -| **-([+/-]** | Exigir ou não parênteses em torno dos argumentos de retorno e sizeof. | -| **símbolo=valor** | Define uma constante, equivalente à diretiva #define, como um parâmetro de linha de comando. | +| Opção | Descrição | +| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **-a** | Apenas assemblador; gera um arquivo .asm que contém o pseudo-código gerado para a máquina abstrata do PAWN. Os "nomes de instrução" no arquivo gerado são realmente diretivas para a ferramenta _pawnasm_, que pode montar o arquivo pseudo-código de volta para binário. | +| **-C[+/-]** | Codificação compacta do binário, gerado ou não; sobrescreve a diretiva #pragma pack. Por padrão, a codificação compacta está habilitada. | +| **-cname** | Nome da página de código ou nome do arquivo; por exemplo -ciso-8859-1. Se o nome não corresponder a uma página de código conhecida, ele é interpretado como um nome de arquivo. | +| **-Dpath** | Diretório de trabalho do compilador, para a tabela de símbolos e quaisquer arquivos temporários. | +| **-d0** | Sem informação simbólica; desabilita a depuração. É impossível usar um depurador simbólico neste modo (mas depuração "printf-assembly" ainda é suportada). | +| **-d1** | Informação simbólica suficiente para rastrear números de linha e nomes de funções; este é o nível padrão de informação de depuração. | +| **-d2** | Informações simbólicas completas; mesma informação de depuração de d1, além de informações simbólicas locais e arrays de comprimento zero. | +| **-d3** | Informações simbólicas completas (como d2) E verificações de tempo de execução habilitadas. | +| **-e filename** | Redirecionar mensagens de erro para o arquivo especificado. | +| **-H value** | "window-handle" (identificador de janela) do ambiente de desenvolvimento integrado (IDE), para propósitos de notificação. O compilador enviará uma mensagem do Windows para a janela especificada quando terminar a compilação. | +| **-i path** | Caminho para arquivos include; múltiplas opções -i são permitidas. | +| **-l** | Criar arquivo de listagem; este é um arquivo de texto com a fonte, o bytecode e a data de endereço. | +| **-o filename** | Especifica nome (e caminho) para o arquivo de saída. | +| **-O level** | Nível de otimização: 0 = sem otimização; 1 = verificações de célula única, propagação de constantes e otimização peephole; mais altos = mais otimizações. | +| **-p filename** | Prefixo do nome do arquivo para o arquivo de saída. | +| **-r[name]** | Escrever relatório de referência cruzada no arquivo de teste (nome) ou em relação ao nome de entrada. | +| **-S value** | Tamanho do stack/heap em células. | +| **-s value** | Número de linhas antes de pular para primeira palavra (padrão = 0 = pular nenhuma linha). | +| **-t value** | TAB: número de caracteres de espaço por tabulação (usado pelo aviso de indentação frouxa). Por padrão, tabulações têm comprimento 8. | +| **-V value** | nível de verbosidade: 0 = silencioso, 1 = avisos normais, 2 = avisos. | +| **-v[+/-]** | habilita/desabilita avisos adicionais de status. | +| **-w number [+/-]** | Habilita/desabilita um aviso específico pelo número. Veja também #pragma warning. | +| **-X value** | Tamanho da máquina abstrata; se zero, haverá apenas verificações de tempo de execução. | +| **-XD value** | Tamanho do segmento de dados abstrato. | +| **-\\** | Usa "\\" em caminhos ao invés de "/". | +| **-^** | Usa "^" ao invés de "\\" como caractere de escape para strings. | +| **-;[+/-]** | Exigir ou não ponto e vírgula para terminar cada instrução. | +| **-([+/-]** | Exigir ou não parênteses em torno dos argumentos de retorno e sizeof. | +| **símbolo=valor** | Define uma constante, equivalente à diretiva #define, como um parâmetro de linha de comando. | Veja a opção "-c" e a página 119 para páginas de código. O padrão do compilador é pegar o nome de saída do nome do "arquivo de entrada" mas com uma extensão @@ -239,16 +239,17 @@ que podem ser alterados por uma diretiva ou opção de linha de comando: O compilador PAWN pode usar várias variáveis de ambiente. -| Variável | Significado | -| ----------- | --------------------------------------------------------------------------------------------------------------------- | -| **PAWNCC** | Mantém opções de linha de comando adicionais | -| **INCLUDE** | Mantém caminho(s) para diretórios de include adicionais (múltiplos caminhos são separados por ";") | +| Variável | Significado | +| ----------- | -------------------------------------------------------------------------------------------------- | +| **PAWNCC** | Mantém opções de linha de comando adicionais | +| **INCLUDE** | Mantém caminho(s) para diretórios de include adicionais (múltiplos caminhos são separados por ";") | ### Sintaxe alternativa para funções públicas Em vez de `public`, você pode usar o prefixo "@" para indicar que uma função é pública: Listagem: declaração de função pública alternativa + ```c @minhafunçãopública() { @@ -301,16 +302,16 @@ Para mais informações sobre a máquina abstrata e as instruções, veja o docu ## Sugestões de documentação -| Etiqueta | Significado | -| ------------ | --------------------------------------------------------- | -| **@author** | Autor da função. | -| **@date** | Data de criação ou última modificação. | -| **@note** | Uma nota ou aviso sobre o uso da função. | -| **@param** | Descrição de um parâmetro da função. | -| **@return** | Descrição do valor de retorno da função. | +| Etiqueta | Significado | +| ------------ | ----------------------------------------------------------- | +| **@author** | Autor da função. | +| **@date** | Data de criação ou última modificação. | +| **@note** | Uma nota ou aviso sobre o uso da função. | +| **@param** | Descrição de um parâmetro da função. | +| **@return** | Descrição do valor de retorno da função. | | **@see** | Referência cruzada para outra função ou tópico relacionado. | -| **@since** | Versão em que a função foi introduzida. | -| **@version** | Versão atual da função. | +| **@since** | Versão em que a função foi introduzida. | +| **@version** | Versão atual da função. | --- diff --git a/frontend/i18n/tr/docusaurus-plugin-content-docs/current/scripting/language/reference/01-Foreword.md b/frontend/i18n/tr/docusaurus-plugin-content-docs/current/scripting/language/reference/01-Foreword.md index 9b2481f96d8..a4152cc8cec 100644 --- a/frontend/i18n/tr/docusaurus-plugin-content-docs/current/scripting/language/reference/01-Foreword.md +++ b/frontend/i18n/tr/docusaurus-plugin-content-docs/current/scripting/language/reference/01-Foreword.md @@ -22,10 +22,10 @@ Ron Cain ve James Hendrix'e (ve daha yakın zamanda Andy Yuen'e), ve Dr. Dobb's Tasarım hedefleri ve uzlaşmaların ayrıntılı bir incelemesi Ek C'de bulunmaktadır; burada birkaç ana noktayı özetlemek isterim. Yukarıdaki paragraflarda belirtildiği gibi, pawn, uygulamaları özelleştirmek (betik yazarak) için, uygulamalar yazmak için değil. Pawn, nesneleri (metin, sprite'lar, akışlar, sorgular, vb.) ana uygulamada manipüle etmeyi amaçladığından pawn programları veri yapılandırmada zayıftır, ancak pawn programına, soyut makinesi dışındaki herhangi bir veriye doğrudan erişim izni verilmez. Bir pawn programının ana uygulamadaki nesneleri manipüle etmek için sahip olduğu tek yol, ana uygulamanın sağladığı alt rutinleri, yani "yerel işlevler"i çağırmaktır. -Pawn, bu alanda esnek bir dildir: işlevleri çağırma. Pawn, bir işlevin herhangi bir argümanı için (sadece sonuncusu değil) varsayılan değerleri, çağrıya referansla çağrı yapma, "adlandırılmış" ve "pozisyonel" işlev argümanlarını destekler. Pawn'ın bir "tür denetimi" mekanizması yoktur, çünkü tip olmayan bir dil olması nedeniyle, ancak yerine bir "sınıflandırma kontrolü" mekanizması olan "etiketler"i sunar. Etiket sistemi, her bir argümanın birden fazla kabul edilebilir etiketi belirtmesine izin verdiği için özellikle işlev argümanları için kullanışlıdır.Ancak bunların birleşiminde. +Pawn, bu alanda esnek bir dildir: işlevleri çağırma. Pawn, bir işlevin herhangi bir argümanı için (sadece sonuncusu değil) varsayılan değerleri, çağrıya referansla çağrı yapma, "adlandırılmış" ve "pozisyonel" işlev argümanlarını destekler. Pawn'ın bir "tür denetimi" mekanizması yoktur, çünkü tip olmayan bir dil olması nedeniyle, ancak yerine bir "sınıflandırma kontrolü" mekanizması olan "etiketler"i sunar. Etiket sistemi, her bir argümanın birden fazla kabul edilebilir etiketi belirtmesine izin verdiği için özellikle işlev argümanları için kullanışlıdır.Ancak bunların birleşiminde. Pawn için, adlandırılmış argümanların —size işlev argümanlarını herhangi bir sırayla belirtme ve varsayılan değerlerin —ilginç olmayan argümanları belirtmeyi atlamınıza izin verme— kombinasyonunun, ana uygulamadaki nesneleri manipüle etmek için (yerel) işlevleri çağırmak için uygun ve "açıklayıcı" bir yol olduğunu düşünüyorum. --- -[İçerik listesine geri dön](00-Contents) \ No newline at end of file +[İçerik listesine geri dön](00-Contents) diff --git a/frontend/i18n/tr/docusaurus-plugin-content-docs/current/scripting/language/reference/02-A-tutorial-introduction.md b/frontend/i18n/tr/docusaurus-plugin-content-docs/current/scripting/language/reference/02-A-tutorial-introduction.md index fb49f19c6c5..de951d4822d 100644 --- a/frontend/i18n/tr/docusaurus-plugin-content-docs/current/scripting/language/reference/02-A-tutorial-introduction.md +++ b/frontend/i18n/tr/docusaurus-plugin-content-docs/current/scripting/language/reference/02-A-tutorial-introduction.md @@ -143,7 +143,7 @@ ve aynı diziyi yazdırır. ---- +--- `"while" döngüsü: 116` @@ -262,7 +262,7 @@ Tarihler, çeşitli algoritmalar ve dönüşüm rutinleri için özellikle zengi "Julian Gün Sayısı", Josephus Scaliger'e† atfedilir ve 4714 M.Ö. 24 Kasım'dan bu yana geçen gün sayısını sayar (proleptik Gregoryen takvimi‡). Scaliger, bu tarihi, üç iyi kurulmuş döngünün - eski Julian takviminin 28 yıllık Güneş Döngüsü, 19 yıllık Meton Döngüsü ve 15 yıllık Indiction Döngüsü (antik Roma'da vergilerin veya hükümet gereksinimlerinin periyodik) - aynı zamana gelmesini işaretlediği ve uzak geçmişte bu özel tarihten önce hiçbir edebiyatın veya kaydedilmiş tarihin bilinmediği tarih olarak seçti. Scaliger, bu konsepti tarih belgelerindeki tarihleri uzlaştırmak için kullandı, - daha sonraki astronomlar, iki olay arasındaki aralıkları daha kolay hesaplamak için bunu benimsedi. +daha sonraki astronomlar, iki olay arasındaki aralıkları daha kolay hesaplamak için bunu benimsedi. --- @@ -541,7 +541,6 @@ main fonksiyonu önce bir mesajı görüntüler ve kullanıcının yazması gere Sonsuz bir döngü için tipik bir kullanım, ortada bir teste ihtiyaç duyulan bir döngüdür - bir nevi while ve do... while döngüsü arasında bir melez. pawn, doğrudan ortada bir testle döngüleri desteklemez, ancak koşullu bir break ile sonsuz bir döngü kodlayarak bir tane taklit edebilirsiniz. Bu örnek programda döngü: - diziden bir kelime alır - testten önce kod; - - yeni bir kelimenin kullanılabilir olup olmadığını test eder ve değilse döngüden çıkar - ortada test; - kelimeyi ve sıra numarasını yazdırır - testten sonraki kod. @@ -672,13 +671,13 @@ Bir küme, elemanlar için genel amaçlı bir konteynerdir. Bir kümenin bir ele Küme işlemleri ile bit işlemleri arasındaki ilişki aşağıdaki tabloda özetlenmiştir. Tabloda, büyük harf bir küme için ve küçük harf bir kümeden bir eleman için temsil eder. -| Kavram | Matematiksel Gösterim | Pawn İfadesi | -| ------------ | --------------------- | --------------- | -| Kesişim | A ∩ B | A & B | -| Birleşim | A ∪ B | A I B | -| Tamamlayıcı | A | ~A | -| Boş küme | ε | 0 | -| Üyelik | x ∈ A | (1 {'<<'} x ) & A | +| Kavram | Matematiksel Gösterim | Pawn İfadesi | +| ----------- | --------------------- | ----------------- | +| Kesişim | A ∩ B | A & B | +| Birleşim | A ∪ B | A I B | +| Tamamlayıcı | A | ~A | +| Boş küme | ε | 0 | +| Üyelik | x ∈ A | (1 {'<<'} x ) & A | --- @@ -858,7 +857,7 @@ Main fonksiyonu önce bir mesaj kutusu oluşturur ve kullanıcının girdiği bi Listeleme: rpnparse.inc -```c +````c /* ana rpn ayrıştırıcı ve leksikal analiz, Ters Lehçe Notasyonu hesap makinesinin bir parçası */ #include @@ -1382,7 +1381,7 @@ Listeleme: traffic2.p ```c -/* Daha gerçekçi bir trafik lambası senkronizatörü, acil araçlar için bir "geçersiz kılma" içerir +/* Daha gerçekçi bir trafik lambası senkronizatörü, acil araçlar için bir "geçersiz kılma" içerir */ #include