وب سایت 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://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: