Skip to content

Commit

Permalink
Fix Build (#12)
Browse files Browse the repository at this point in the history
* rewrite md comments

* update content

* Update build-contribute.ts

* update contribute docs export

* skip invalid md

* improve relative image link rewrite logic

* Update astro.config.mjs

* Update description.mdx

* Create index.astro

* [slug] to [...slug]

* remove unneeded deps

* temporary manual fixes
  • Loading branch information
outofambit authored Mar 5, 2024
1 parent 2fc0abc commit ff89bb4
Show file tree
Hide file tree
Showing 137 changed files with 8,062 additions and 11,495 deletions.
7 changes: 7 additions & 0 deletions astro.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -19,4 +19,11 @@ export default defineConfig({
build: {
format: "directory",
},
i18n: {
defaultLocale: "en",
locales: ["en", "ar", "es", "hi", "ko", "pt-br", "sk", "zh"],
routing: {
prefixDefaultLocale: true,
},
},
});
12,133 changes: 4,717 additions & 7,416 deletions package-lock.json

Large diffs are not rendered by default.

3 changes: 2 additions & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -46,15 +46,16 @@
"eslint-plugin-react": "^7.33.2",
"gray-matter": "^4.0.3",
"html-entities": "^1.3.1",
"is-absolute-url": "^4.0.1",
"marked": "^4.0.10",
"path": "^0.12.7",
"prettier": "^3.2.5",
"prettier-plugin-tailwindcss": "^0.5.11",
"remark": "^15.0.1",
"remark-gfm": "^4.0.0",
"remark-mdx": "^3.0.1",
"simple-git": "^3.22.0",
"tsx": "^4.7.1",
"yaml": "^2.4.0",
"yuidocjs": "^0.10.2"
}
}
38 changes: 19 additions & 19 deletions src/content/contributor-docs/ar/README.mdx
Original file line number Diff line number Diff line change
@@ -1,44 +1,46 @@
# 🌸مرحبا 🌺

---
شكرا لإهتمامك بالمساهمة في p5.js! مجتمعنا يقدر المساهمات بكل أشكالها ويسعى إلى توسيع معنى كلمة "مساهم/ة" بأقصى شكل ممكن؛ بشكل يتضمن توثيق البرمجيات، التدريس، كتابة الشيفرة البرمجية، صناعة الفن، الكتابة، التصميم، النشاطية، التنظيم، نَظْم المحتوى أو أي شيء أخر يمكن أن تتخيله. [صفحة المجتمع خاصتنا](https://p5js.org/community/#contribute) تعطي ملخصا للطرق المختلفة التي يمكن بها المشاركة والمساهمة معنا.

---
# 🌸مرحبا 🌺
شكرا لإهتمامك بالمساهمة في p5.js! مجتمعنا يقدر المساهمات بكل أشكالها ويسعى إلى توسيع معنى كلمة "مساهم/ة" بأقصى شكل ممكن؛ بشكل يتضمن توثيق البرمجيات، التدريس، كتابة الشيفرة البرمجية، صناعة الفن، الكتابة، التصميم، النشاطية، التنظيم، نَظْم المحتوى أو أي شيء أخر يمكن أن تتخيله. [صفحة المجتمع خاصتنا](https://p5js.org/community/#contribute) تعطي ملخصا للطرق المختلفة التي يمكن بها المشاركة والمساهمة معنا.
هذا المشروع يتبع المواصفات القياسية لمشروع [all-contributors "كل المساهمين"](https://github.com/kentcdodds/all-contributors). نحن نستعمل البوت @all-contributors كي نضيف المساهمين/ات إلى الملف README.md. يمكنك الطلب من البوت @all-contributors أن يضيفك عن طريق كتابة الآتي في تعليق على طلب مشكلة "issue" على جيت هب "GitHub" أو طلب سحب"pull request" :

هذا المشروع يتبع المواصفات القياسية لمشروع [all-contributors "كل المساهمين"](https://github.com/kentcdodds/all-contributors). نحن نستعمل البوت @all-contributors كي نضيف المساهمين/ات إلى الملف README.md. يمكنك الطلب من البوت @all-contributors أن يضيفك عن طريق كتابة الآتي في تعليق على طلب مشكلة "issue" على جيت هب "GitHub" أو طلب سحب"pull request" :
```
@all-contributors please add @[اسم المسخدم خاصتك على جيت هب] for [نوع مساهمتك]
```

يمكنك معرفة نوع مساهمتك المناسب من [هنا](https://allcontributors.org/docs/en/emoji-key)، على الرغم من أننا غالبا سنضيفك بشكل تلقائي إلى قائمة المساهمين بعد قبول طلب السحب خاصتك. دليل المساهمين منشور على [موقع](https://p5js.org/contributor-docs/#/) p5.js ومُستضاف على[ مستودع "repository" جيت هب](https://github.com/processing/p5.js/tree/main/contributor_docs) الخاص بـ p5.js.

# قبل المساهمة معنا

المساهمة في مشروع p5.js يجب أن تكون تجربة خالية من أي ضغط، فنحن نرحب بكل المساهمات بغض النظر عن حجمها، سواء كانت إصلاح خطأ مطبعي بسيط أو إعادة هيكلة الآليات المعقدة لعرض الرسوم ثلاثية الأبعاد، لكن توجد بعض الأشياء التي يجب معرفتها وفهمها قبل البدء في المساهمة.

بدايةً: من فضلك قم/قومي بقراءة [بيان مجتمعنا](https://p5js.org/community/)

أما بعد: نحن حاليا نعطي الأولوية للأعمال التي تُزيد الوصول (إمكانية الوصول والإتاحة وحقوق المعاقين/ات) لـ p5.js! للمزيد من التفاصيل، يمكنك إلقاء نظرة على [بيان الإتاحة خاصتنا](./access/)
أما بعد: نحن حاليا نعطي الأولوية للأعمال التي تُزيد الوصول (إمكانية الوصول والإتاحة وحقوق المعاقين/ات) لـ p5.js! للمزيد من التفاصيل، يمكنك إلقاء نظرة على [بيان الإتاحة خاصتنا](./access/)

# البدء

الآن أنت على استعداد لبدء المساهمة في p5.js! هناك العديد من الطرق لبدء المساهمة إلى p5.js وأيضا العديد من الأسباب للمساهمة معنا. في سياق هذا الدليل، سنقسم المساهمات بشكل عام إلى قسمين:

<ul dir="rtl">
<li>المساهمات التي تتعامل بشكل مباشر مع الشيفرة المصدرية (هذا يتضمن التوثيق البرمجي)</li>
<li>المساهمات التي قلما تتعامل مع الشيفرة المصدرية أو لا تتعامل مها على الإطلاق</li>
<li>المساهمات التي تتعامل بشكل مباشر مع الشيفرة المصدرية (هذا يتضمن التوثيق البرمجي)</li>
<li>المساهمات التي قلما تتعامل مع الشيفرة المصدرية أو لا تتعامل مها على الإطلاق</li>
</ul>

على حسب نوع المساهمة المراد القيام بها إلى p5.js، يمكنك قراءة الجزء المناسب من هذا الدليل.

## [المساهمات إلى الشيفرة المصدرية](./contributor_guidelines/)
للقيام بمساهمة مثالية إلى مستودع p5.js أو موقع p5.js، يجب إتباع الخطوات الآتية:

للقيام بمساهمة مثالية إلى مستودع p5.js أو موقع p5.js، يجب إتباع الخطوات الآتية:

<ol dir="rtl">
<li>عمل طلب مشكلة على جيت هب</li>
<li>مناقشة طلب المشكلة</li>
<li>الحصول على موافقة لعمل بطلب سحب</li>
<li>تغيير الشيفرة المصدرية</li>
<li>عمل طلب سحب</li>
<li>مناقشة طلب السحب</li>
<li>الموافقة على طلبك وضمه</li>
<li>عمل طلب مشكلة على جيت هب</li>
<li>مناقشة طلب المشكلة</li>
<li>الحصول على موافقة لعمل بطلب سحب</li>
<li>تغيير الشيفرة المصدرية</li>
<li>عمل طلب سحب</li>
<li>مناقشة طلب السحب</li>
<li>الموافقة على طلبك وضمه</li>
</ol>

في هذه[ الصفحة](./contributor_guidelines/)، سيتم توجهيك خطوة بخطوة لتنفيذ الخطوات المذكورة أعلاه، يمكنك استعمال فهرس تلك الصفحة للوصول إلى الأجزاء المراد مراجعتها أو تذكرها.
Expand All @@ -48,11 +50,9 @@
**نحن نرى المساهمة إلى p5.js كفرصة للتعلم** ولا نقيس النجاح بعدد المساهمات التي تصلنا. لا توجد مهلة تَحدُك لتنفيذ مساهمتك، لذا يمكنك اتخاذ الوقت والسرعة المناسبة لك (قد نراسلك إذا غبت لفترة طويلة). يمكنك سؤال المتعهدين/ات أو المشرفين/ات إذا احتجتهم وسوف نبذل قصارى جهدنا حتى نساعدك.

## المساهمات إلى غير الشيفرة المصدرية

هناك العديد من الطرق للمساهمة إلى p5.js بعيدا عن الشيفرة المصدرية، أكثر حتى من أن نحصيها هنا، بعض الطرق قد تتضمن العمل مع مستودع p5.js (كإضافة الأمثلة، أو كتابة درس للموقع، إلخ). على حسب المساهمة المخطط لها، قد تكون لدينا القدرة على مساعدتك بطرق عدة، لذا يمكنك التواصل معنا عبر أي قناة من قنوات التواصل المتاحة لك (البريد الإلكتروني، وسائل التواصل الإجتماعي، منتدى النقاش، ديسكورد، إلخ).

## [المتعهدين/ات والمشرفين/ات](./steward_guidelines/)

للدليل الخاص بالمتعهدين/ات أو الصيانة العامة لمستودع p5.js على جيت هب، يمكنك إلقاء نظرة على [دليل المتعهدين](./steward_guidelines/)



19 changes: 11 additions & 8 deletions src/content/contributor-docs/en/README.mdx
Original file line number Diff line number Diff line change
@@ -1,33 +1,36 @@

---

---
# 🌸 Welcome! 🌺

Thanks for your interest in contributing to p5.js! Our community values contributions of all forms and seeks to expand the meaning of the word "contributor" as far and wide as possible. It includes documentation, teaching, writing code, making art, writing, design, activism, organizing, curating, or anything else you might imagine. [Our community page](https://p5js.org/community/#contribute) gives an overview of some different ways to get involved and contribute.

This project follows the [all-contributors](https://github.com/kentcdodds/all-contributors) specification. We use the @all-contributors bot to handle adding people to the README.md file. You can ask @all-contributors bot to add you in an issue or PR comment like so:

```
@all-contributors please add @[your GitHub handle] for [your contribution type]
```

You can find relevant contribution type [here](https://allcontributors.org/docs/en/emoji-key). Although we will usually automatically add you to the contributor list using the bot after merging your PR. The contributor docs are published on p5.js [website](https://p5js.org/contributor-docs/#/), and hosted on p5.js [GitHub repository](https://github.com/processing/p5.js/tree/main/contributor_docs).

# Before Contributing

Contributing to p5.js should be a stress free experience and we welcome contributions of all levels, whether you are just fixing a small typo in the documentation or refactoring complex 3D rendering functionalities. However there are just a few things you should be familiar with before starting your contribution.

First, please have a read through our [community statement](https://p5js.org/community/).

Next, we are currently prioritizing work that expands access (inclusion and accessibility) to p5.js! See [our access statement](./access/) for more details.

# Get Started

Now you are ready to start contributing to p5.js! There are many ways to get started with contributing to p5.js and many reasons to do so. For the purpose of this documentation, we will split contributions roughly into two categories.
- Contributions that directly deals with the source code (including documentation)
- Contributions that directly deals with the source code very little or not at all

* Contributions that directly deals with the source code (including documentation)
* Contributions that directly deals with the source code very little or not at all

Depending on what kind of contribution you are making to p5.js, please read on to the relevant section of this documentation.

## [Source code contribution](./contributor_guidelines/)

For a typical contribution to the p5.js or p5.js-website repository, we will follow the following steps:

1. Open an issue
2. Discuss
3. Approved for opening a Pull Request (PR)
Expand All @@ -43,9 +46,9 @@ Most of the time we will stick with this workflow quite strictly and, especially
**We see contributing to p5.js as a learning opportunity** and we don't measure sucess by only looking at the volume of contributions we received. There is no time limit on how long it takes you to complete a contribution, so take your time and work at your own pace (we may check in after a long period of inactivity). Ask for help from any of the stewards or maintainers if you need them and we'll try our best to support you.

## Non-source code contribution

There are many more ways to contribute to p5.js through non-source code contribution than can be exhaustively listed here, some of the ways may also involve working with some of the p5.js repositories (such as adding examples, writing tutorials for the website, etc.). Depending on what the planned contribution is, we may be able to support you in different ways so do reach out to us via any channel available to you (email, social media, [Discourse forum](https://discourse.processing.org/c/p5js/10), Discord, etc).

## [Stewards and maintainers](./steward_guidelines/)
For information related to area stewards or general maintenance of p5.js GitHub repository, please check out the [steward guidelines](./steward_guidelines/).

For information related to area stewards or general maintenance of p5.js GitHub repository, please check out the [steward guidelines](./steward_guidelines/).
Loading

0 comments on commit ff89bb4

Please sign in to comment.