From ee8273f4c5e349db85e43aa29f57de57ab055cb6 Mon Sep 17 00:00:00 2001 From: rakeshnagar10 Date: Mon, 28 Sep 2026 16:09:16 +0530 Subject: [PATCH] gu in translate bundles file --- .../current/blueprints/06-bundles.md | 330 ++++++++++++++++++ 1 file changed, 330 insertions(+) create mode 100644 packages/docs/site/i18n/gu/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md diff --git a/packages/docs/site/i18n/gu/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md b/packages/docs/site/i18n/gu/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md new file mode 100644 index 00000000000..bdb808600da --- /dev/null +++ b/packages/docs/site/i18n/gu/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md @@ -0,0 +1,330 @@ +--- +title: બ્લુપ્રિન્ટ બંડલ્સ +slug: /blueprints/bundles +description: બ્લુપ્રિન્ટ બંડલ્સ વિશે જાણો, જે સ્વયં-સમાવિષ્ટ પેકેજો છે જેમાં blueprint.json ફાઇલ અને તેના તમામ જરૂરી સંસાધનો સામેલ છે. +--- + +# બ્લુપ્રિન્ટ બંડલ્સ + + + +બ્લુપ્રિન્ટ બંડલ્સ સ્વયં-સમાવિષ્ટ પેકેજો છે જેમાં બ્લુપ્રિન્ટ ઘોષણા (`blueprint.json`) તેમજ તેને કમ્પાઇલ કરવા અને ચલાવવા માટે જરૂરી તમામ વધારાના સંસાધનો સામેલ હોય છે. આ સંપૂર્ણ વર્ડપ્રેસ પ્લેગ્રાઉન્ડ સેટઅપ્સને વહેંચવાનું અને શેર કરવાનું સરળ બનાવે છે. + + + +## બ્લુપ્રિન્ટ બંડલ્સ શું છે? + + + +બ્લુપ્રિન્ટ બંડલ એ ફાઇલોનો સંગ્રહ છે જેમાં નીચેની વસ્તુઓ સામેલ છે: + + + +1. `blueprint.json` ફાઇલ જે બ્લુપ્રિન્ટ કન્ફિગરેશન વ્યાખ્યાયિત કરે છે +2. બ્લુપ્રિન્ટ દ્વારા સંદર્ભિત કોઈપણ વધારાના સંસાધનો (થીમ્સ, પ્લગઇન્સ, સામગ્રી ફાઇલો, વગેરે) + + + +બ્લુપ્રિન્ટ બંડલ્સ વિવિધ ફોર્મેટમાં વહેંચી શકાય છે: + + + +- ટોચના સ્તરની `blueprint.json` ફાઇલ અને વધારાના સંસાધનો ધરાવતી ZIP ફાઇલ +- git રિપોઝીટરીની અંદરની ડિરેક્ટરી જ્યાં અન્ય સંસાધનો સાથે `blueprint.json` રહેલો છે +- તમારા કમ્પ્યુટર પર સ્થાનિક ડિરેક્ટરી +- ઇનલાઇન કરવામાં આવેલી સંબંધિત ફાઇલો સાથેનો ઇનલાઇન જાવાસ્ક્રિપ્ટ ઑબ્જેક્ટ + + + +## બ્લુપ્રિન્ટ બંડલ્સનો ઉપયોગ કરવો + + + +### વેબસાઇટ પર + + + +વર્ડપ્રેસ પ્લેગ્રાઉન્ડ વેબસાઇટ ડૉકમાં **New → Blueprint URL** દ્વારા અથવા `?blueprint-url=` ક્વેરી પેરામીટર દ્વારા બ્લુપ્રિન્ટ બંડલ્સને સપોર્ટ કરે છે. તમે તમારા બ્લુપ્રિન્ટ બંડલ ધરાવતી ZIP ફાઇલની URL પ્રદાન કરી શકો છો: + + + +``` +https://playground.wordpress.net/?blueprint-url=https://example.com/my-blueprint-bundle.zip +``` + +ZIP ફાઇલમાં રૂટ સ્તર પર `blueprint.json` ફાઇલ હોવી જોઈએ, સાથે બ્લુપ્રિન્ટ દ્વારા સંદર્ભિત કોઈપણ વધારાના સંસાધનો હોવા જોઈએ. + + + +### CLI માં + + + +પ્લેગ્રાઉન્ડ CLI `--blueprint=` વિકલ્પ દ્વારા બ્લુપ્રિન્ટ બંડલ્સને સપોર્ટ કરે છે. તમે નીચેની વસ્તુઓ પ્રદાન કરી શકો છો: + + + +- બ્લુપ્રિન્ટ બંડલ ધરાવતી સ્થાનિક ડિરેક્ટરીનો પાથ +- બ્લુપ્રિન્ટ બંડલ ધરાવતી સ્થાનિક ZIP ફાઇલનો પાથ +- રિમોટ બ્લુપ્રિન્ટ બંડલની URL (http:// અથવા https://) + + + +ઉદાહરણ તરીકે: + + + +```bash +# Using a local ZIP file +npx @wp-playground/cli --blueprint=./my-blueprint.zip server + +# Using a remote URL +npx @wp-playground/cli --blueprint=https://example.com/my-blueprint.zip server + +# Using a local directory +npx @wp-playground/cli --blueprint=./my-blueprint-directory server +``` + +સુરક્ષા કારણોસર CLI મૂળભૂત રીતે સ્થાનિક ફાઇલોની ઍક્સેસને પ્રતિબંધિત કરે છે. જો તમારા બ્લુપ્રિન્ટને એ જ પેરેન્ટ ડિરેક્ટરીમાં ફાઇલોને ઍક્સેસ કરવાની જરૂર હોય, તો તમારે `--blueprint-may-read-adjacent-files` ફ્લેગનો ઉપયોગ કરીને સ્પષ્ટપણે પરવાનગી આપવી પડશે: + + + +```bash +npx @wp-playground/cli --blueprint=./my-blueprint.json --blueprint-may-read-adjacent-files server +``` + +## બ્લુપ્રિન્ટ બંડલ્સ બનાવવું + + + +### મૂળભૂત માળખું + + + +મૂળભૂત બ્લુપ્રિન્ટ બંડલ કંઈક આના જેવું દેખાઈ શકે છે: + + + +``` +my-blueprint-bundle/ +├── blueprint.json +├── theme.zip +├── plugin.zip +└── content/ + └── sample-content.wxr +``` + +### બંડલ કરેલા સંસાધનો સાથે ઉદાહરણ બ્લુપ્રિન્ટ + + + +અહીં એક `blueprint.json` ફાઇલનું ઉદાહરણ છે જે બંડલ કરેલા સંસાધનોનો સંદર્ભ આપે છે: + + + +```json +{ + "landingPage": "/my-file.txt", + "steps": [ + { + "step": "writeFile", + "path": "/wordpress/my-file.txt", + "data": { + "resource": "bundled", + "path": "/bundled-text-file.txt" + } + }, + { + "step": "installTheme", + "themeData": { + "resource": "bundled", + "path": "/theme.zip" + } + }, + { + "step": "installPlugin", + "pluginData": { + "resource": "bundled", + "path": "/plugin.zip" + } + }, + { + "step": "importWxr", + "file": { + "resource": "bundled", + "path": "/content/sample-content.wxr" + } + } + ] +} +``` + +આ ઉદાહરણમાં, બ્લુપ્રિન્ટ કેટલાક બંડલ કરેલ સંસાધનોનો સંદર્ભ આપે છે: + + + +- `/bundled-text-file.txt` પર આવેલી ટેક્સ્ટ ફાઇલ +- `/theme.zip` પર આવેલી થીમ ZIP ફાઇલ +- `/plugin.zip` પર આવેલી પ્લગઇન ZIP ફાઇલ +- `/content/sample-content.wxr` પર આવેલી WXR કન્ટેન્ટ ફાઇલ + + + +### ZIP બંડલ બનાવવું + + + +ZIP બંડલ બનાવવા માટે, ખાલી તમારી `blueprint.json` અને તમામ જરૂરી સંસાધનો સાથે એક ડિરેક્ટરી બનાવો, અને પછી તેને ઝિપ કરો: + + + +```bash +# Create a directory for your bundle +mkdir my-blueprint-bundle +cd my-blueprint-bundle + +# Create your blueprint.json and add resources +# ... + +# Zip it up +zip -r ../my-blueprint-bundle.zip . +``` + +## ZIP ફાઇલ સ્ટ્રક્ચર ફ્લેક્સિબિલિટી + + + +બ્લુપ્રિન્ટ બંડલ્સ ZIP ફાઇલમાં બે સ્થાનો પર `blueprint.json` ને સપોર્ટ કરે છે: + + + +1. **રૂટ લેવલ** (પ્રમાણભૂત): `blueprint.json` સીધી ZIP રૂટ પર રહે છે +2. **એક ડિરેક્ટરી ઊંડે**: `blueprint.json` સિંગલ ટોપ-લેવલ ડિરેક્ટરીની અંદર રહે છે + + + +આનો અર્થ એ છે કે macOS ના રાઇટ-ક્લિક "Compress" ફીચર (જે સામગ્રીને ફોલ્ડરમાં લપેટે છે) સાથે બનાવેલ ZIP ફાઇલો આપોઆપ કાર્ય કરે છે. ડિટેક્શન દરમિયાન `__MACOSX` મેટાડેટા ડિરેક્ટરીને અવગણવામાં આવે છે. + + + +**ઉદાહરણ: આ બંને ZIP સ્ટ્રક્ચર્સ કાર્ય કરે છે:** + + + +``` +# Structure A (root level) +my-bundle.zip/ +├── blueprint.json +├── theme.zip +└── plugin.zip + +# Structure B (one directory deep — macOS-style) +my-bundle.zip/ +├── my-bundle/ +│ ├── blueprint.json +│ ├── theme.zip +│ └── plugin.zip +└── __MACOSX/ ← ignored +``` + +જો બહુવિધ ટોપ-લેવલ ડિરેક્ટરીઓમાં `blueprint.json` હોય, તો પ્લેગ્રાઉન્ડ અસ્પષ્ટતા ટાળવા માટે ભૂલ પરત કરે છે. + + + +## મુશ્કેલીનિવારણ + + + +જો તમને બ્લુપ્રિન્ટ બંડલ્સ સાથે સમસ્યાઓનો સામનો કરવો પડે છે: + + + +1. ખાતરી કરો કે તમારી `blueprint.json` ફાઇલ તમારી ZIP ફાઇલના રૂટ લેવલ પર છે અથવા સિંગલ ટોપ-લેવલ ડિરેક્ટરીની અંદર છે +2. તપાસો કે તમારા બંડલ કરેલા સંસાધન સંદર્ભોમાં તમામ પાથ સાચા છે +3. ચકાસો કે તમારી ZIP ફાઇલ યોગ્ય રીતે ફોર્મેટ થયેલ છે +4. CLI નો ઉપયોગ કરતી વખતે, તપાસો કે શું તમને `--blueprint-may-read-adjacent-files` ફ્લેગની જરૂર છે +5. ખાતરી કરો કે તમામ જરૂરી સંસાધનો બંડલમાં સામેલ છે + +