برنامه نویسی

وب سایت Jekyll Github Pages – Community Dev

این راهنمای شخصی من است که مربوط به همه چیز در مورد ساخت صفحات GitHub با و بدون جکیل است.

1. وب سایت Github Pages (بدون Jekyll + فقط پرونده های Markdown)

  • بازپوی مرجع: این
  • وب سایت مرجع: این
  • این برنامه شامل مضامین ، بدون ویژگی های اضافی صفحات GitHub و غیره است. فقط ساده ترین شکل وب سایت GitHub Pages.
  • فرآیند:

    1. یک repo را آغاز کنید
    2. یک پرونده readme و هر پرونده markdown دیگری را که می خواهید قرار دهید اضافه کنید.
    3. به برگه تنظیمات repo ، بخش های صفحات بروید ، اینها شاخه اصلی و فهرست اصلی را انتخاب می کنند. در بعضی مواقع URL وب سایت در صفحه فعلی (فقط پس از مدتی بارگیری مجدد) قرار می گیرد.
  • ویژگی ها:

    1. اجازه می دهد تا ویژگی های عادی پرونده های Markdown: پیوندها ، نحو Markdown و غیره
    2. بدون مضامین ، ناوبر اتوماتیک و غیره

2. وب سایت Github Pages (با موضوع Jekyll + فقط پرونده های Markdown)

  • repo مرجع: این
  • وب سایت مرجع: این
  • فرآیند:

    1. مراحل 1 تا 3 همانند بالا
    2. یک فایل _config.yml اضافه کنید که حاوی موضوعی است که توسط GitHub و سایر پیکربندی های مربوط به آن موضوع پشتیبانی می شود ، repo خود را ارائه می دهد.
  • ویژگی ها:

    1. اجازه می دهد تا ویژگی های عادی پرونده های Markdown: پیوندها ، نحو Markdown و غیره
    2. GitHub از مضامین پشتیبانی شده و هر ویژگی مربوط به آن موضوع به تنهایی (بدون تنظیمات سفارشی خارج از آنچه که آن موضوع می تواند ارائه دهد)

3. وب سایت صفحات GitHub Autogenerated (با تم Jekyll + Markdown + Files HTML)

  • repo مرجع: این
  • وب سایت مرجع: این
  • پیش نیازها:

  • فرآیند:

    • ایجاد صفحه وب: اجرا کنید jekyll new my-site
    • اجرای صفحه وب به صورت محلی: اجرا کنید bundle exec jekyll serve
    • اجرای صفحه وب با GitHub: فشار به repo و تنظیم صفحات GitHub از طریق تنظیمات (به عنوان نقطه 3 در اینجا)
  • ویژگی ها:

    1. Files Markdown Neccessary و HTML ، Gemfile با سنگهای از پیش تعریف شده ، _config.yml با تنظیمات و موضوع از پیش تعیین شده.
    2. فقط کافی است پرونده های Markdown بیشتری را به پوشه _posts اضافه کنید تا پست های بیشتری به وب سایت اضافه کنید. همه چیز دیگر به صورت خودکار است

4. وب سایت GitHub صفحات از ابتدا (با Jekyll + Markdown + Files HTML + گردش کار صفحات GitHub)

  • repo مرجع: این
  • وب سایت مرجع: این
  • پیش نیازها:

  • فرآیند:

    • ایجاد a _config.yml
    • برای خواص ، به https://json.schemastore.org/jekyll.json مراجعه کنید. در این مورد به کلید به نام Properties بروید و در زیر آن هر کلید یک ویژگی ممکن است که می تواند به پرونده پیکربندی اضافه شود.
    • برای خصوصیات پیش فرض خاص برای هر موضوع یا الگوی وب سایت خاص ، به آن الگوی مراجعه کرده و مستندات یا پایه کد آن را بخوانید تا مشخص شود که چه متغیرهایی در کد آن استفاده می شود.
    • یافتن متغیرها:
    • https%3A%2F%2Fgithub
    • https%3A%2F%2Fgithub
    • ما از https://github.com/pages-themes/architect استفاده خواهیم کرد. من فقط جلو می روم و اطلاعات را از آن کپی می کنم _config.yml
    • فایلی به نام ایجاد کنید Gemfile
    • مانند بسته است. json اما برای روبی. این شامل سنگهای قیمتی (بسته های نصب) است
    • در آن سنگهای لازم برای جکیل و موارد مربوط به موضوع/الگوی مربوطه اضافه کنید. (مثال)
    • با دویدن سنگ قیمتی را بسته بندی کنید bundle install یا فقط bundle
    • فایلی به نام ایجاد کنید .gitignore مخصوص جکیل ، به طور خودکار با اجرای npx gitignore jekyll
    • افزودن پرونده ها:
    • یک فایل readme اضافه کنید که یک نقطه شروع را انجام دهد
    • پیشکسوت Additonal را به هر پست یا صفحه ای که می کنید اضافه کنید. (مثال)
    • صفحات علامت گذاری سفارشی را اضافه کنید [optional]بشر (مثال)
    • صفحات HTML سفارشی را اضافه کنید [optional]بشر (مثال)
  • دویدن:

    • اجرای صفحه وب به صورت محلی: اجرا کنید bundle exec jekyll serve
    • اجرای صفحه وب با GitHub: فشار دهید تا صفحات GitHub را از طریق تنظیمات تنظیم کنید

5. وب سایت صفحات GitHub از ابتدا (با Jekyll + Markdown + Files HTML + گردش کار GitHub سفارشی)

  • repo مرجع: این
  • وب سایت مرجع: این وب سایت وبلاگ فعلی
  • فرآیند:

    • هر چیز مشابه 4 ، اما ما گردش کار خودمان را خواهیم ساخت.
    • این امر زمانی لازم است که ما در کد اصلی Jekyll تغییراتی ایجاد کنیم ، زیرا گوهر صفحات GitHub هیچ تغییری را که در کد اصلی Jekyll ایجاد شده است در نظر نمی گیرند. بنابراین ما گردش کار GitHub خودمان را می سازیم.
  • گردش کار GitHub:
    • پوشه ای به نام اضافه کنید .github، که در آن پوشه دیگری اضافه می کنید workflows، که در آن پرونده ای به نام اضافه می کنید jekyll.yml
    • در آن پرونده کد زیر را اضافه می کنید
  • دویدن:

    • همان 4
    • اجرای صفحه وب به صورت محلی: اجرا کنید bundle exec jekyll serve
    • اجرای صفحه وب با GitHub: فشار دهید تا صفحات GitHub را از طریق تنظیمات تنظیم کنید

◈ یادداشت های اضافی:

  • لیست پرونده های استارت برخی از وب سایت های صفحات ساده و زیبا:

  • برخی از منابع دیگر برای تنظیم وب سایت GitHub Pages:

نوشته های مشابه

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *

دکمه بازگشت به بالا