urlzap
v1.0.0
أداة تقصير عناوين URL الثابتة الخاصة بك ⚡️
تحظى مولدات المواقع الثابتة المنشورة على صفحات Github بشعبية كبيرة في الوقت الحاضر. ولكن ماذا عن أداة تقصير عناوين URL الثابتة (ناهيك عن المولد)، والتي تسمح لك بإعادة توجيه عناوين URL بناءً على الملفات الثابتة؟
عادةً ما يقوم المطورون في نهاية المطاف بإعداد خادم يتضمن عمليات إعادة توجيه لهذا الغرض (وليس بشكل ثابت). وهنا يأتي دور URLZap. فهو يُنشئ عناوين URL باستخدام الملفات ومعالج HTML، مما يسمح للمستخدمين باستضافة عمليات إعادة توجيه عناوين URL الخاصة بهم إلى صفحات Github.
يشبه مولدات مواقع الويب الثابتة، ولكن لعناوين URL
احتفظ بعناوين URL (المختصرة أو غير المختصرة) معك
يمكن استخدامها مع صفحات جيثب
لا حاجة لتشغيل خادم أو إعداد عمليات إعادة توجيه HTTP 301
مشروع مثال: brunoluiz/_
ربما تسأل نفسك: كيف يتم ذلك بدون خادم؟ حسنًا، الجواب يكمن في <meta http-equiv="refresh" /> . إنه يعمل كرمز حالة HTTP 301 (إعادة التوجيه)، ولكن يتم ذلك من جانب العميل. هناك المزيد من الشرح على موقع w3c.
استنادًا إلى ملف config.yml الذي يحتوي على المسار وعنوان URL المطلوبين، سيقوم urlzap بإنشاء ملفات index.html التي تستخدم علامات التحديث التعريفي. إنه ليس مثاليًا مثل HTTP 301، ولكنه قريب جدًا. يتم استخدام إستراتيجية مماثلة من قبل مولدات مواقع الويب الثابتة الأخرى، مثل Hugo.
على سبيل المثال سيكون:
المسار: './links' # الافتراضي هو './'urls: google: https://google.com الأدوات: جيثب: https://github.com
سيتم تعيين كل مفتاح في الخريطة إلى مسارات {.path param}/{key} ، وإعادة التوجيه إلى {value} . وهذا من شأنه أن يولد ما يلي:
- links/ - google/ - index.html (contains redirect) - tools/ - github/ - index.html (contains redirect)
يمكن تحميل هذه الملفات على صفحات Github على سبيل المثال، دون الحاجة إلى أي خادم. على brunoluiz/_ يمكنك رؤية مثال config.yml والتحقق من الإخراج في فرع gh-pages
تحقق من قسم الإصدارات لمزيد من التفاصيل المعلومات
استخدم brew لتثبيته
brew tap brunoluiz/tap brew install urlzap
باستخدام مثال YAML السابق:
المسار: './links' # الافتراضي هو './'urls: google: https://google.com الأدوات: جيثب: https://github.com
urls : خريطة عنوان URL المطلوبة، باتباع النمط {key}:{redirect URL}
path : مسار الإخراج
لإنشاء الملفات الثابتة، قم بتشغيل urlzap generate .
على الأرجح سينتهي بك الأمر باستخدام Github Pages مع هذه الأداة. إذا كان الأمر كذلك، فربما تكون أفضل طريقة لاستخدامها وجني فوائدها هي من خلال Github Actions. توجه إلى brunoluiz/urlzap-github-action لمزيد من التفاصيل حول كيفية تثبيته، وتغطية الإنشاء والنشر.
️ قد تحتاج إلى تمكين صفحات Github يدويًا في مستودعك! مزيد من التفاصيل في دليل صفحات جيثب
إذا لم تكن إجراءات Github مناسبة لك، فجرب العملية اليدوية التالية بدلاً من ذلك.
قم بتمكين صفحات Github وقم بإعداد الفرع حيث سيتم وضع ملفات HTML الثابتة الخاصة بك. مزيد من التفاصيل في دليل صفحات جيثب
قم بإعداد config.yml الخاص بك
الالتزام والدفع إلى main
قم بالخروج إلى فرع Github Pages الخاص بك (عادةً gh-pages ) وقم بتشغيل git reset --hard origin/main (سيؤدي هذا إلى إعادة تعيين HEAD إلى master )
قم بتشغيل urlzap generate
الالتزام والدفع
يتبع البرنامج النصي التالي ما هو موضح في الخطوات أعلاه:
#!/bin/bash# يضيف التغييرات ويلتزم بها ويدفعها إلى add config.yml git Commit -m 'chore: تحديث config.yml'git Push -u Origin main# جعل فرع gh-pages هو نفسه فرع maingit checkout gh-pages إعادة ضبط git - الأصل الثابت/الرئيسي # إنشاء الملفات urlzap إنشاء # إضافة الملفات التي تم إنشاؤها والالتزام بها ودفعها git add --all git Commit -m 'chore: تحديث ملفات HTML'git Push -u Origin gh-pages --force
