openfaas.github.io
1.0.0
พื้นที่เก็บข้อมูลนี้มีเว็บเพจและบล็อก OpenFAAS - https://www.openfaas.com สร้างขึ้นโดยใช้ Jekyll และส้อมที่แก้ไขของเทมเพลต CloudCannon Frisco และสร้าง/โฮสต์โดยใช้หน้า GitHub
ส่วนต่อไปนี้ให้คำแนะนำพื้นฐานสำหรับการเปลี่ยนแปลงทั่วไปบางอย่างที่จะทำกับเว็บไซต์เพิ่มโพสต์ผู้เขียน ฯลฯ
โพสต์บล็อกทั้งหมดต้องมีชื่อ และ คำอธิบายสิ่งนี้จะช่วยในการทำ SEO ชื่อของผู้แต่งสามารถกล่าวถึงในคำอธิบาย
รูปแบบ:
คำแนะนำสั้น ๆ/ภาพรวม (150 คำ)
ชุดของขั้นตอนตรรกะหรือคะแนน / หัวข้อ
ฝังไดอะแกรมแนวคิดวิดีโอหรือรูปภาพเพื่อช่วยสร้างเคส
ชี้ไปที่เอกสาร/gitHub หรืออย่างอื่น
หากจำเป็นต้องแสดงการตอบรับผู้อื่นที่ร่วมมือหรือให้ข้อเสนอแนะที่คุณใช้ เมื่อทำงานกับ GitHub สิ่งนี้มีอยู่ในประวัติศาสตร์สาธารณะดังนั้นให้ใช้เท่าที่จำเป็น
เมื่อใช้ขั้นตอนใช้เสียงที่ใช้งานอยู่/จำเป็นสำหรับส่วนหัว
ดี:
แย่:
ภาษาอังกฤษมีการพูดกันอย่างแพร่หลาย แต่ไม่ใช่ภาษาแรกของผู้อ่านทุกคน สิ่งพิมพ์นี้ยังครอบคลุมหัวข้อทางเทคนิคมากมายคุณอาจเป็นผู้เชี่ยวชาญ แต่ผู้อ่านของคุณไม่น่าจะเป็นเช่นนั้นดังนั้นให้พิจารณาทั้งสองอย่างนี้เมื่อคุณเขียนบทความของคุณ
เขียนเป็นภาษาอังกฤษธรรมดาตลอดเวลาเมื่อมีคำที่ง่ายกว่าใช้ให้หลีกเลี่ยงคำที่ได้มาจากละตินเมื่อเป็นไปได้หลีกเลี่ยง gerunds ที่คำกริยาที่ใช้งานอยู่สามารถแทนที่ได้
หากคุณกำลังเขียนบทความเสียงของคุณควรจะเจอและประสบการณ์ของคุณ นั่นคือเหตุผลที่คุณกำลังเขียนโพสต์ - พยายามหลีกเลี่ยงการใช้กาลหรือข้อความที่คุณสามารถใช้ประโยคที่เริ่มต้นด้วย I
ก่อน:
หลังจาก:
ใช้ประโยคสั้น ๆ :
ก่อน:
หลังจาก:
สำหรับคำแนะนำเพิ่มเติมบางอย่างดู:
โพสต์นี้โดย Raphael A. Finkel มหาวิทยาลัยเคนตักกี้
และ [ก่อนและหลัง] http://www.plainenglish.co.uk/campaigning/examples/before-and-after.html] จาก plainenglish.co.uk
ในขณะที่ใช้คำที่สนุกสนานเช่น "Boom!", "Fun and Profit" และสร้างเรื่องตลกในข้อความสามารถทำงานได้ดีในบล็อกส่วนตัว บล็อกและเอกสารของ OpenFAAS ควรใช้คำว่า "สนุก" หรือ "น่ารัก" แบบนี้น้อยที่สุด
ความคิดเห็นควรนำเสนอเป็นมุมมองของคุณเอง หากคุณมีข้อมูลในการสำรองตำแหน่งของคุณสิ่งนี้จะช่วยให้จุดของคุณน่าเชื่อถือ หากคุณไม่มีข้อมูลตรวจสอบให้แน่ใจว่าผู้อ่านเข้าใจสิ่งนี้โดยเกี่ยวข้องกับตัวเอง I believe that .. I found it easier to ..
หากคุณระบุข้อมูลข้อเท็จจริง / วัตถุประสงค์คุณควรสำรองข้อมูลด้วยเครื่องหมายคำพูดลิงค์ ฯลฯ
ระวังกฎหมายลิขสิทธิ์ หากคุณใช้ไดอะแกรมหรือฝังใบเสนอราคาจากที่ไหนสักแห่งให้แน่ใจว่าคุณให้การระบุแหล่งที่มาที่เหมาะสม
วางรูปภาพทั้งหมดในโฟลเดอร์ย่อย ./images/<post-name>
แต่ละโพสต์ควรมีภาพถ่ายพื้นหลังที่เลือกจากการถ่ายภาพสต็อกฟรีหรือให้ใบอนุญาตครีเอทีฟคอมมอนส์ อย่าดึงภาพเข้ามาจาก Google โดยไม่ตรวจสอบว่าการใช้งาน / ใบอนุญาตนั้นถูกต้องก่อน ครอบตัดพื้นหลังถึงความกว้าง 1600 พิกเซล ใช้ JPEG และ AIM สำหรับขนาด 200KB-280KB เมื่อส่งออก (เพิ่มการบีบอัด)
คุณสามารถลดขนาดต่อไปได้โดยการ จำกัด "คุณภาพ" ของ JPEG จาก 100% ถึงสิ่งที่ต่ำกว่า 70-75%
ปั้น
สาด
ภาพและภาพหน้าจอในโพสต์
แต่ละโพสต์บล็อกควรมีแผนภาพแนวคิดอย่างน้อยหนึ่งรายการ สิ่งนี้ควรแสดงการไหลแบบลอจิคัลหรือมุมมองนามธรรมของคุณลักษณะข่าวหรือการออกแบบ ทวีตหรือวิดีโอที่ฝังตัวสามารถตอบสนองวัตถุประสงค์นี้ได้
รูปภาพมีความสำคัญสำหรับทุกโพสต์ แต่พยายามบีบอัด / ครอบตัดภาพให้มากที่สุดเท่าที่สมเหตุสมผลและเป็นไปได้ สิ่งนี้จะช่วยลดขนาดใหญ่ที่ GitHub repo สามารถเติบโตได้ซึ่งเต็มไปด้วยภาพ
เนื้อหาข้ามโพสต์ส่งผลเสียต่อคะแนน SEO ดังนั้นไม่ควรทำเว้นแต่การดูแลและความสนใจเพิ่มเติมจะรวมถึงส่วนหัว "OG" ที่จำเป็น ตรวจสอบให้แน่ใจว่าเนื้อหาทั้งหมดในบล็อกชุมชน OpenFaas เป็นต้นฉบับ
มีการจัดทำไฟล์ Docker เพื่อลดความซับซ้อนของการพัฒนา/สนับสนุนเว็บไซต์และบล็อกสิ่งนี้ได้รับการยืนยันว่าทำงานทั้ง OSX และ Windows 10 (เมื่อพัฒนา/เขียนบน Windows โปรดใช้ Unix Line Endings ในโปรแกรมแก้ไขของคุณ)
เรียกใช้เว็บไซต์ในพื้นที่ด้วย:
docker compose up
สิ่งนี้จะทำให้ไซต์พร้อมใช้งานในพื้นที่ที่ - http: // localhost: 4000
Starting openfaas-www_openfaas-jekyll_1 ... done
Attaching to openfaas-www_openfaas-jekyll_1
openfaas-jekyll_1 | ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-linux-musl]
openfaas-jekyll_1 | Configuration file: /srv/jekyll/_config.yml
openfaas-jekyll_1 | Source: /srv/jekyll
openfaas-jekyll_1 | Destination: /srv/jekyll/_site
openfaas-jekyll_1 | Incremental build: disabled. Enable with --incremental
openfaas-jekyll_1 | Generating...
openfaas-jekyll_1 | Remote Theme: Using theme cloudcannon/frisco-jekyll-template
openfaas-jekyll_1 | done in 3.074 seconds.
openfaas-jekyll_1 | Auto-regeneration: enabled for '/srv/jekyll'
openfaas-jekyll_1 | Server address: http://0.0.0.0:4000
openfaas-jekyll_1 | Server running... press ctrl-c to stop.
การเปลี่ยนแปลงใด ๆ ที่เกิดขึ้นกับเว็บไซต์ในตัวแก้ไขของคุณจะถูกหยิบขึ้นมาภายในคอนเทนเนอร์และเว็บไซต์จะถูกสร้างใหม่ ( โปรดทราบว่า นี่ไม่รวมถึงการเปลี่ยนแปลง _config.yml คุณต้องรีสตาร์ทคอนเทนเนอร์ Docker เพื่อรับการเปลี่ยนแปลงเหล่านั้น)
ตัวอย่างเช่นหากคุณเพิ่มโพสต์ของคุณเองใน _posts/2018-07-31-my-post.md คุณจะเห็น Jekyll ตรวจจับการเปลี่ยนแปลงและสร้างเว็บไซต์ใหม่รีเฟรชเบราว์เซอร์ของคุณจะรับการเปลี่ยนแปลงใด ๆ
openfaas-jekyll_1 | Regenerating: 1 file(s) changed at 2018-07-31 21:28:36
openfaas-jekyll_1 | _posts/2018-08-22-my-post.md
openfaas-jekyll_1 | Remote Theme: Using theme cloudcannon/frisco-jekyll-template
openfaas-jekyll_1 | ...done in 2.0199265 seconds.
_data/users.ymlimages/users-logos/ ส่วนผู้มีส่วนร่วมในหน้า Landing Page กำลังถูกสร้างขึ้นโดยใช้สคริปต์ node ขนาดเล็กที่อยู่ในไฟล์ generate-stats.js ขอแนะนำให้คุณเรียกใช้สคริปต์นี้ก่อนที่จะเปิดการประชาสัมพันธ์ สิ่งนี้จะทำให้มั่นใจได้ว่าส่วนผู้มีส่วนร่วมจะทันสมัย:
node generate-stats.js
หมายเหตุ: ต้องติดตั้ง node.js ในระบบของคุณ
เพื่อให้มีการโพสต์บล็อกอย่างถูกต้องนำมาประกอบกับผู้เขียนพวกเขาจะต้องเพิ่มเข้ากับทีมโดยการสร้างไฟล์ <author_name>.md ในไดเรกทอรี _staff_members
การแสดงของสมาชิกในทีมในหน้าทีมขึ้นอยู่กับตำแหน่งในไฟล์ data/members.yml
การระบุแหล่งที่มาในบล็อกโพสต์ขึ้นอยู่กับชื่อไฟล์
ตัวอย่างเช่น _staff_members/alex.md สามารถใช้สำหรับการระบุแหล่งที่มาโดยการตั้งค่าข้อมูลเมตาต่อไปนี้โพสต์:
author_staff_member: alex
ซึ่งส่งผลให้กล่องผู้เขียนแสดงด้วยโพสต์ที่ได้รับมอบหมายแต่ละรายการ:
คำจำกัดความของผู้แต่งใช้รูปแบบต่อไปนี้:
---
name: Alex Ellis
position: Founder
image_path: /images/author/ellis.jpg
twitter_username: alexellisuk
blurb: Founder of <a href="https://twitter.com/openfaas">@openfaas</a>. Open Source <a href="https://twitter.com/vmware">@vmware</a>.
---
| สำคัญ | รายละเอียด |
|---|---|
| ชื่อ | ชื่อเต็มของผู้เขียนที่มีส่วนร่วม |
| ตำแหน่ง | คำอธิบายข้อความฟรีเกี่ยวกับความสัมพันธ์กับโครงการ |
| image_path | เส้นทางไปยังภาพผู้เขียนนี่ควรเป็นภาพ 154px * 154px |
| twitter_username | ผู้แต่ง Twitter Handle (ไม่มี @ ) |
| การแจ้งเตือน | ข้อมูลข้อความฟรีเกี่ยวกับผู้ใช้นี่ควรจะสั้นมาก |
### มีส่วนร่วมในการโพสต์
การมีส่วนร่วมโพสต์นั้นตรงไปตรงมาเช่นเดียวกับการเพิ่มการประชาสัมพันธ์ที่มีโพสต์ของคุณในรูปแบบ markdown พร้อมกับภาพที่ฝังอยู่
การทำเครื่องหมายโพสต์ของคุณควรถูกสร้างขึ้นในไดเรกทอรี _posts และไฟล์ควรใช้โครงสร้างต่อไปนี้
yyyy-mm-dd-short-description-of-post.md
หากคุณมีข้อสงสัยลองดูโพสต์ที่มีอยู่สำหรับแนวคิดเกี่ยวกับสิ่งที่ยอมรับได้
โพสต์ประกอบด้วยสองส่วนส่วนหัวของ Yaml Front Matter ซึ่งอธิบายการโพสต์และให้ jekyll ด้วยตัวชี้นำสำหรับการแสดงผล/การระบุแหล่งที่มา ฯลฯ และโพสต์ร่างกายซึ่งเป็นเพียง markdown มาตรฐาน
ข้อมูลเมตาโพสต์ใช้แบบฟอร์มต่อไปนี้:
---
title: Introducing the OpenFaaS Operator for Serverless on Kubernetes
date: 2018-07-14
image: /images/kubernetes-operator-crd/pexels-asphalt-blue-sky-clouds-490411.jpg
categories:
- kubernetes
author_staff_member: alex
canonical_url: https://blog.alexellis.io/introducing-the-openfaas-operator/
---
| สำคัญ | รายละเอียด |
|---|---|
| ชื่อ | ชื่อของโพสต์บล็อก |
| วันที่ | เผยแพร่วันที่โพสต์บล็อกในรูปแบบ yyyy-mm-dd |
| ภาพ | Path to Image ซึ่งจะแสดงอยู่ด้านหลังชื่อเรื่องนี้ควรเพิ่มในไดเรกทอรีที่มีชื่อเดียวกับโพสต์บล็อกภายใต้ไดเรกทอรี images |
| หมวดหมู่ | รายการเสริมของหมวดหมู่ที่โพสต์อยู่ภายใต้คุณควรนำหมวดหมู่ที่มีอยู่กลับมาใช้ใหม่จากโพสต์ก่อนหน้านี้ที่เป็นไปได้ |
| ผู้เขียน _staff_member | ชื่อของไฟล์ผู้เขียนในไดเรกทอรี _staff_members ใช้สำหรับการระบุแหล่งที่มา (ดูส่วนก่อนหน้า) |
| Canonical_url | คุณ ต้อง ตั้งค่าฟิลด์นี้หากโพสต์บล็อกได้รับการเผยแพร่ที่ URL อื่นแล้ว การตั้งค่าจะถูกกำหนดให้กับเนื้อหาต้นฉบับ |
ในขณะที่ Jekyll รองรับหลายรูปแบบคุณควรส่งโพสต์ของคุณในรูปแบบ Markdown
คู่มือต่อไปนี้อธิบายไวยากรณ์:
นอกจากนี้ยังมีประโยชน์อย่างมากในการเปรียบเทียบโพสต์ที่มีอยู่กับไฟล์ Markdown พื้นฐานเมื่อคุณต้องการเรียนรู้วิธีการจัดรูปแบบโพสต์ของคุณ
การเพิ่มรูปภาพใช้รูปแบบ markdown ปกติและในขณะที่ภาพภายนอกเป็นไปได้ที่คุณต้องการรวมรูปภาพใด ๆ ในการประชาสัมพันธ์ของคุณสิ่งเหล่านี้ควรไปในไดเรกทอรีที่มีชื่อเดียวกับโพสต์ภายใต้ไดเรกทอรี images เช่น images/kubernetes-operator-crd/
หมายเหตุ ดูแลให้มีขนาดภาพที่เหมาะสมเท่านั้นคุณควรตรวจสอบให้แน่ใจว่าคุณได้ปรับขนาด/ประมวลผลภาพใด ๆ ก่อนที่จะเพิ่มลงใน PR ของคุณ
ไซต์ใช้ภาษา SASS Stylesheet การเปลี่ยนแปลงใด ๆ ในการดูและความรู้สึกของไซต์จะต้องทำโดยใช้ SASS อย่ามีส่วนร่วมไฟล์. .css ดิบ
นอกจากนี้เรายังใช้ Bulma เป็นกรอบ CSS ของเรา ก่อนที่จะทำการเปลี่ยนแปลง / เพิ่มเติมสไตล์โปรดพิจารณา:
NAVBAR และส่วนท้ายของไซต์ได้รับการกำหนดค่าผ่าน YAML ในไฟล์ต่อไปนี้:
_data/footer.yml_data/navigation.ymlการเพิ่มรายการลงในนั้นควรเป็นทางเลือกสุดท้ายเพราะพวกเขาจะต้องไม่รก
สำหรับความเข้าใจโดยละเอียดเพิ่มเติมเกี่ยวกับวิธีการสร้างเว็บไซต์โปรดดูเอกสาร Jekyll และ GitHub หน้า:
ไซต์ยังใช้ปลั๊กอินต่อไปนี้:
อ้างถึง documenation ด้านบนสำหรับรายละเอียดเกี่ยวกับวิธีการใช้และกำหนดค่าปลั๊กอินแต่ละตัว
rm -rf outg/ * ; ffmpeg -i videoplayback.mp4 -vf " select='not(mod(n,2000))',setpts='N/(30*TB)' " -f image2 -y outg/out%03d.jpg
ffmpeg -f image2 -framerate 1 -i outg/out%003d.jpg -vf " scale=width=-2:height=ih/2 " out.gif
