openfaas.github.io
1.0.0
이 저장소에는 OpenFaas 웹 페이지 및 블로그 -https://www.openfaas.com이 포함되어 있으며 Jekyll과 Cloudcannon Frisco Template의 수정 된 포크를 사용하여 GitHub 페이지를 사용하여 빌드/호스팅됩니다.
다음 섹션에서는 사이트에 대한 일반적인 변경 사항에 대한 기본 가이드를 제공하여 게시물, 저자 등을 추가합니다.
모든 블로그 게시물에는 제목 과 설명이 있어야하므로 SEO에 도움이됩니다. 저자의 이름은 설명에 언급 될 수 있습니다.
체재:
짧은 소개/개요 (150 단어)
일련의 논리적 단계 또는 포인트 / 주제
케이스를 만드는 데 도움이되는 개념 다이어그램, 비디오 또는 그림을 포함시킵니다.
문서/github 또는 다른 것을 가리 키십시오.
필요한 경우 공동 작업을하거나 피드백을 제공 한 다른 사람에게 감사의 말을 표시하십시오. GitHub에서 작업 할 때는 공개 역사에서 사용할 수 있으므로 드물게 사용하십시오.
단계를 사용하면 제목에 활성/명령형 음성을 사용하십시오.
좋은:
나쁜:
영어는 널리 사용되지만 모든 독자의 첫 언어는 아닙니다. 이 출판물은 또한 많은 기술 주제를 다루고 있으며 전문가 일지 모르지만 독자는 가능성이 없으므로 기사를 작성할 때이 두 가지를 모두 고려하십시오.
더 간단한 단어가 존재하면 항상 평범한 영어로 쓰고 가능하면 라틴어에서 파생 된 단어를 피하고 활성 동사가 대체 할 수있는 Gerunds를 피하십시오.
기사를 작성하는 경우 목소리가 나오고 경험이 나와야합니다. 그렇기 때문에 게시물을 작성하는 이유입니다. 수동 시제 나 진술을 사용하지 않으려 고 노력하십시오. 여기서 I 로 시작하는 문장을 사용할 수 있습니다.
전에:
후에:
짧은 문장 사용 :
전에:
후에:
추가 권장 사항은 다음을 참조하십시오.
이 게시물, Raphael A. Finkel, 켄터키 대학교.
그리고 [전후] http://www.plainenglish.co.uk/campaigning/examples/before-and-safter.html]에서 plenenglish.co.uk
"붐!", "재미와 이익"과 같은 재미있는 용어를 사용하고 텍스트로 농담을하는 동안 개인 블로그에서 잘 작동 할 수 있습니다. OpenFaas 블로그 및 문서는 이러한 종류의 "재미"또는 "귀여운"이용 약관을 최소화해야합니다.
의견은 자신의 견해로 제시되어야합니다. 위치를 백업 할 데이터가 있으면 포인트를 신뢰할 수있게됩니다. 데이터가 없다면 독자가 자신과 관련하여 이것을 이해하도록 I found it easier to .. I believe that ..
사실 / 객관적인 데이터를 진술하는 경우 인용문, 링크 등으로이를 백업해야합니다.
저작권법을 조심하십시오. 다이어그램을 사용하거나 어딘가에서 견적을 포함시키는 경우 적절한 속성을 제공하십시오.
모든 이미지를 하위 폴더에 배치하십시오 ./images/<post-name>
각 게시물에는 무료 스톡 포토 그래피에서 배경 사진을 선택하거나 크리에이티브 커먼즈 라이센스를 제공해야합니다. 사용 / 라이센스가 먼저 유효한지 확인하지 않고 Google에서 이미지를 가져 오지 마십시오. 배경을 1600 픽셀의 너비로 자릅니다. JPEG를 사용하고 내보낼 때 크기가 200kb-280kb를 목표로합니다 (압축 증가).
JPEG의 "품질"을 100%에서 70-75%보다 낮은 것으로 제한하여 크기를 더 줄일 수 있습니다.
Pexels
Unsplash
포스트 이미지 및 스크린 샷
각 블로그 게시물에는 하나 이상의 개념 다이어그램이 있어야합니다. 이것은 기능, 뉴스 또는 디자인의 논리적 흐름 또는 추상적 견해를 보여 주어야합니다. 임베디드 트윗이나 비디오 도이 목적을 달성 할 수 있습니다.
이미지는 모든 게시물에 중요하지만 이미지를 합리적이고 가능한 한 이미지를 압축 / 자르려고 노력하십시오. 이것은 이미지로 가득 찬 Github Repo가 성장할 수있는 거대한 크기를 완화하는 데 도움이됩니다.
크로스 포스트 컨텐츠는 SEO 점수에 부정적인 영향을 미치므로 추가 관리 및주의가 필요한 "OG"헤더를 포함하도록주의를 기울이지 않으면 수행해서는 안됩니다. OpenFaas 커뮤니티 블로그의 모든 콘텐츠가 독창적인지 확인하십시오.
Docker Compose 파일은 웹 사이트 및 블로그에 대한 개발/기여를 단순화하기 위해 제공되며 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/ 에 복사하십시오. 방문 페이지의 기고자 섹션은 generate-stats.js 파일에있는 작은 node 스크립트를 사용하여 생성됩니다. PR을 열기 전에이 스크립트를 실행하는 것이 좋습니다. 이를 통해 기고자 섹션이 최신 상태가되도록합니다.
node generate-stats.js
참고 : 시스템에 node.js를 설치해야합니다.
저자에게 올바른 블로그 게시물을 얻으려면 _staff_members 디렉토리에서 <author_name>.md 파일을 만들어 팀에 추가해야합니다.
팀 페이지에 팀 구성원 표시는 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 | 저자 트위터 핸들 ( @ 없음) |
| 추천 광고 | 사용자에 대한 무료 텍스트 정보는 매우 짧아야합니다. |
### 게시물에 기여합니다
게시물을 기고하는 것은 모든 내장 이미지와 함께 Markdown 형식으로 게시물을 포함하는 PR을 올리는 것만 큼 간단합니다.
Post Markdown은 _posts 디렉토리에 생성되어야하며 파일은 다음 구조를 취해야합니다.
yyyy-mm-dd-short-description-of-post.md
의심스러운 경우 수용 가능한 내용에 대한 아이디어에 대한 기존 게시물을 살펴보십시오.
포스트는 포스트를 설명하고 렌더링/속성 등에 대한 신호를 제공하는 Yaml Front Matter 헤더 인 두 부분으로 구성됩니다.
포스트 메타 데이터는 다음과 같은 형태를 취합니다.
---
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 형식으로 블로그 게시물의 날짜를 게시하십시오 |
| 영상 | 제목 뒤에 표시되는 이미지로 표시되는 경로는 images 디렉토리 아래 블로그 게시물과 동일한 이름의 디렉토리에 추가되어야합니다. |
| 카테고리 | 게시물이 떨어지는 카테고리의 선택적 목록은 가능한 경우 이전 게시물에서 기존 카테고리를 항상 재사용해야합니다. |
| author_staff_member | _staff_members 디렉토리의 저자 파일의 이름, 귀속에 사용됩니다 (이전 섹션 참조) |
| canonical_url | 블로그 게시물이 이미 다른 URL에 게시 된 경우이 필드를 설정 해야합니다 . 원래 콘텐츠를 선호합니다. |
Jekyll은 여러 형식을 지원하지만 게시물을 Markdown 형식으로 제출해야합니다.
다음 안내서는 구문을 설명합니다.
게시물을 포맷하는 방법을 배우려면 기존 게시물을 기본 마크 다운 파일과 비교하는 것이 매우 유용합니다.
이미지 추가는 일반 마크 다운 형식을 사용하며 외부 이미지가 PR에 이미지를 포함하는 것이 좋지만 images 디렉토리 아래의 게시물과 동일한 이름의 디렉토리로 이동해야합니다 (예 : images/kubernetes-operator-crd/ .
참고 현명한 이미지 크기 만 포함하도록주의하십시오. PR에 추가하기 전에 이미지 크기를 조정/처리한지 확인해야합니다.
이 사이트는 SASS 스타일 시트 언어를 사용합니다. SASS를 사용하여 사이트 모양과 느낌에 대한 변경 사항은 RAW .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
