Merge branch 'main' into add-donate-page-zh

Author: Darrenhqf

src/components/ReferenceDirectoryWithFilter/index.tsx

@@ -3,6 +3,7 @@ import { useMemo, useRef, useState } from "preact/hooks";
 import { type JSX } from "preact";
 import { Icon } from "../Icon";
 import flask from "@src/content/ui/images/icons/flask.svg?raw"; 
+import warning from "@src/content/ui/images/icons/warning.svg?raw"; 
 
 type ReferenceDirectoryEntry = ReferenceDocContentItem & {
   data: {
@@ -43,6 +44,10 @@ const getOneLineDescription = (description: string): string => {
   let [oneLineDescription] = description.replace(/\n/g, " ").trim()
     .match(firstParagraphRegex) ?? [];
 
+  if (!oneLineDescription && description) {
+    oneLineDescription = description;
+  }
+
   if(oneLineDescription){
     oneLineDescription = oneLineDescription
       .replace(/^<p>|<\/p>$/g, "")
@@ -108,6 +113,12 @@ export const ReferenceDirectoryWithFilter = ({
                     dangerouslySetInnerHTML={{ __html: flask }}
                   />
                 )}
+                {entry.data.deprecated && (
+                  <div
+                    className="inline-block mr-2 w-[16px] h-[16px] mb-[-2px]"
+                    dangerouslySetInnerHTML={{ __html: warning }}
+                  />
+                )}
                 <span dangerouslySetInnerHTML={{ __html: entry.data.title }} />
               </span>
               <p

src/content/reference/config.ts

@@ -64,6 +64,7 @@ export const referenceSchema = z.object({
   submodule: z.string().optional(),
   file: z.string(),
   description: z.string().optional(),
+  deprecated: z.string().optional(),
   line: z.number().or(z.string().transform((v) => parseInt(v, 10))),
   params: z.array(paramSchema).optional(),
   overloads: z.array(z.object({ params: z.array(paramSchema) })).optional(),

src/content/text-detail/hi/code-of-conduct.mdx

@@ -0,0 +1,23 @@
+---
+title: "आचार संहिता"
+---
+
+- **अपनी भाषा का ध्यान रखें.** निम्नलिखित में से कोई भी व्यवहार अस्वीकार्य है:
+
+  - लिंग, पहचान, यौन पसंद, रंग, जाति, भाषा, सोचने का तरीका, शरीर का आकार, क्षमता, वर्ग, धर्म, संस्कृति, समूह, राजनीति, उम्र, हुनर, काम या पृष्ठभूमि के बारे में बुरे कमेंट न करें।
+  - हिंसा की धमकी न दें।
+  - किसी को जानबूझकर न डराएं।
+  - बिना मतलब के या बिना चेतावनी के यौन या हिंसा वाली चीज़ें न दिखाएं।
+  - किसी पर बिना चाहे यौन ध्यान न दें।
+  - किसी का पीछा न करें।
+  - या किसी भी तरह से परेशान न करें।
+
+  सोच-समझकर काम करें। अगर कुछ ऐसा है जिससे दूसरे शायद परेशान हों, तो उसे न डालें।
+
+- **सम्मान करें।** जब राय अलग हो, तो दूसरों के विचारों पर गुस्सा न करें। याद रखें, हर बात को शांति और ध्यान से समझें।
+- **ध्यान रखें।** सोचें कि आपकी बात से समुदाय के लोगों पर क्या असर होगा।
+- **खुले विचारों वाले बनें। ** नए लोगों और नए विचारों का स्वागत करें। हमारा ग्रुप हमेशा बदल रहा है, और हम अच्छे बदलावों का स्वागत करते हैं।
+
+अगर आपको लगे कि कोई नियम तोड़ रहा है, तो [[email protected]](mailto:[email protected]) पर ईमेल करके बताएं। अपना नाम और घटना के बारे में लिखें, हम जल्दी ही आपसे संपर्क करेंगे।
+
+कभी-कभी, नियम तोड़ने वालों को पता नहीं होता कि उनकी हरकत गलत है, और बात करने से मामला ठीक हो जाता है। लेकिन, अगर कोई बार-बार ऐसा करे, तो p5.js टीम जो ठीक लगे वो कर सकती है, जैसे कि उसे p5.js से हटाना और दूसरों को बताना कि वो परेशान करने वाला है।

src/content/text-detail/hi/contact.mdx

@@ -0,0 +1,5 @@
+---
+title: "संपर्क करें"
+---
+
+आप हमसे [[email protected]](mailto:[email protected]) पर संपर्क कर सकते हैं।

src/content/ui/en.yaml

@@ -186,6 +186,7 @@ calloutTitles:
   "Try this!": "Try this!"
   Tip: Tip
   Note: Note
+  Warning: Warning
 LibrariesLayout:
   View All: View All
   Featured: Featured

src/content/ui/images/icons/warning.svg

@@ -20,6 +20,7 @@ import type {
 import { setJumpToState } from "../globals/state";
 import { p5Version } from "../globals/p5-version";
 import flask from "@src/content/ui/images/icons/flask.svg?raw"; 
+import warning from "@src/content/ui/images/icons/warning.svg?raw"; 
 
 const { entry, relatedEntries } = Astro.props;
 const currentLocale = getCurrentLocale(Astro.url.pathname);
@@ -106,6 +107,18 @@ const descriptionParts = description.split(
           <p>{t('experimentalApi', 'description')}</p>
         </div>
       )}
+      {entry.data.deprecated && (
+        <div class="deprecated">
+          <h5>
+            <div
+              class="inline-block mr-2 w-[20px] h-[20px] mb-[-2px]"
+              set:html={warning}
+            />
+            {t('calloutTitles', 'Warning')}
+          </h5>
+          <p set:html={entry.data.deprecated} />
+        </div>
+      )}
       {descriptionParts.map((part) => {
         if (part.startsWith('<pre')) {
           const exampleCode = part

src/layouts/ReferenceItemLayout.astro

@@ -255,6 +255,7 @@ const convertToMDX = async (
     file: doc.file.replace(/.*p5\.js\/(.*)/, "$1"),
     description: doc.description ?? "",
     line: doc.line,
+    deprecated: doc.deprecated,
   } as Record<string, unknown>;
 
   // Add specific frontmatter based on the type of doc

src/scripts/builders/reference.ts

@@ -128,8 +128,7 @@ export const saveYuidocOutput = async (
     const inPath = path.join(__dirname, "in", inDirName);
     console.log(inPath)
     await new Promise((resolve, reject) => {
-      exec(`yuidoc -p --outdir ${outputFilePath} ${flags} ${inputPath}`, { cwd: inPath }, (error, stdout) => {
-        if (error) {
+exec(`yuidoc -p --outdir "${outputFilePath.replace(/"/g, '\\"')}" ${flags} ${inputPath}`, { cwd: inPath }, (error, stdout) => {        if (error) {
           console.error(`Error running YUIDoc command: ${error}`);
           reject(error);
         } else {

src/scripts/parsers/reference.ts

@@ -291,7 +291,7 @@ pre.code-box,
   white-space: break-spaces;
 }
 
-.callout, .experimental {
+.callout, .experimental, .deprecated {
   padding: var(--spacing-sm);
   border-radius: 20px;
   background-color: var(--bg-magenta-20);
@@ -308,7 +308,7 @@ pre.code-box,
   }
 }
 
-.experimental {
+.experimental, .deprecated {
   background-color: var(--bg-yellow);
 }