Ubuntu 17.10에 Raneto를 설치하는 방법

• 전제 조건
• 로그인
• Node.js 및 PM2 설치
• Raneto 설치
• 추가 구성
• 페이지 추가
• 카테고리 추가

Raneto는 Node.js를 기반으로하는 무료 오픈 소스 지식 기반으로, 설정 및 사용이 쉽고 관리가 용이합니다. 카테고리와 페이지는 마크 다운으로 작성되므로 쉽게 편집 할 수 있습니다. Markdown이 마음에 들지 않으면 Raneto에서 HTML을 사용할 수도 있습니다.

전제 조건

• Ubuntu 17.10이 설치된 VPS
• VPS에 대한 SSH 액세스.
• 리눅스 터미널에 대한 기본 지식.

로그인

먼저 SSH를 사용하여 서버에 로그인해야합니다. 이렇게하려면 자주 사용하는 SSH 클라이언트를여십시오.

ssh root@SERVER_IP

암호를 입력하면 (Vultr 대시 보드에서 얻을 수 있음) VPS에 로그인됩니다.

Node.js 및 PM2 설치

Raneto는 Javascript 런타임 및 프레임 워크 인 Node.js에서 실행됩니다. 이 학습서에서는 장기 지원으로 Node.js v8을 사용합니다. 다음 명령을 입력하여 설치를 시작하십시오.

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -

이 스크립트 실행이 완료되면 기본 설치를 실행할 수 있습니다.

sudo apt-get install -y nodejs

이 설치 관리자가 완료되면 VPS에 최신 Node.js 사본이 설치됩니다. 다음으로, Raneto (및 기타 많은 Node.js 애플리케이션)를보다 쉽게 ​​실행할 수 있도록 Node.js의 프로세스 관리자 인 PM2를 설치하려고합니다.

npm install pm2 -g

이제 Raneto를 설치하는 데 필요한 모든 소프트웨어가 있습니다.

Raneto 설치

우리는 Git을 사용하여 Raneto 저장소를 서버에 복제 할 것입니다.

git clone https://github.com/gilbitron/Raneto.git

라는 폴더가 생성됩니다 Raneto. 폴더를 입력하십시오.

cd Raneto

NPM을 설치하십시오.

npm install

다음을 입력하여 Gulp를 실행하십시오.

npm run gulp

Gulp가 실행을 마치면 다음 두 명령 중 하나를 사용하여 응용 프로그램을 시작할 수 있습니다.

npm start
# or
npm example/server.js

로 이동하여 새 Raneto 설치에 액세스 할 수 있습니다 SERVER_IP:3000. 이 튜토리얼의 나머지 부분에서는 Raneto를 추가로 구성하고, 새 페이지를 만들고, 카테고리를 추가하고, 정렬을 조정하고, 사용자 정의 홈페이지를 추가하고, 템플릿을 편집하는 방법에 대해 설명합니다.

추가 구성

이제 VPS에서 호스팅되는 기본 Raneto 설치가 완료되었습니다. 다른 작업을 시작하기 전에 기본 구성 및 설정을 약간 변경하는 것이 좋습니다.

폴더 config.default.js에 있는를 살펴 보겠습니다 example. 이 설정 파일은 꽤 길지만, 주석을 많이 달았으므로 압도하지 마십시오. 편집해야 할 속성은 다음과 같습니다.

• site_title -웹 사이트 제목으로 변경하십시오.
• base_url-사이트 URL로 설정해야합니다. 페이지를 편집 할 때 변수로 사용할 수 있습니다.
• support_email-유효한 이메일로 변경하십시오. 사이트 바닥 글에 표시됩니다.
• copyright -바닥 글 텍스트.
• analytics -여기에 Google 웹 로그 분석 추적 코드를 추가하십시오.
• allow_editing -웹 편집기를 사용하여 파일을 편집 할 수 있습니까?
• authentication_for_read -사람들이 웹 사이트를보기 위해 로그인하도록 하시겠습니까?
• credentials -로그인이 활성화 된 경우 여기에 사용자를 추가하십시오.
• locale -언어.
• datetime_format -날짜 및 시간 형식.
• home_meta -홈페이지의 메타 정보를 변경하려면이를 편집하십시오.
• table_of_content -Raneto는 목차를 표시해야합니까?

온라인 편집기 사용

Raneto는 페이지, 카테고리 등을 관리하기 위해 사용하기 쉬운 온라인 인터페이스를 제공합니다. 모든 작업을 수행 할 수는 없지만 이동 중에 빠른 편집이 필요한 경우 확실히 도움이됩니다.

config.default.js위에서 언급 한대로 설정을 활성화 한 다음 VPS를 방문하고 오른쪽 상단의 로그인 버튼을 클릭하여 액세스 할 수 있습니다 . 사용자 이름과 비밀번호를 입력하고 (에서 변경할 수 있음 config.default.js) 로그인을 클릭하십시오. 편집해야 할 페이지를 클릭하고 Actions드롭 다운을 클릭 한 후 완료 할 작업을 선택하십시오. +카테고리 이름 옆에 있는 버튼 을 눌러 페이지를 추가 할 수 있으며 왼쪽 상단의 입력 필드를 사용하여 카테고리를 만들 수 있습니다.

페이지 추가

폴더 .md에 새 마크 다운 ( ) 문서 를 만드는 것처럼 페이지를 추가하는 것이 간단 example/content합니다.

새 마크 다운 파일을 만든 후에는 파일 상단에 몇 가지 기본 정보를 추가해야합니다. 자주 사용하는 텍스트 편집기에서 파일을 엽니 다. 파일 맨 위에 다음을 추가해야합니다.

/*
 Title: Enter your page title here, if none is added, the file-name will be used
 Description: Enter your page's description here (for search engines and the site search feature)
 ShowOnHome: true/false
 */

필요한 경우 페이지에서 다음 변수를 사용할 수도 있습니다.

• %base_url% -웹 사이트의 URL을 언급 할 수 있습니다.
• %image_url% -이미지 디렉토리의 기본 URL을 얻을 수 있습니다.

카테고리 추가

지식 기반에 범주를 쉽게 추가 할 수 있습니다. example/content디렉토리에 새 폴더를 만들고 해당 범주에 포함하려는 페이지를 해당 폴더에 넣으십시오. 예를 들어, 우리라는 범주 원 말할 help라는 페이지를을 contact, help-me하고 awesome. 파일은 다음과 같습니다.

/example/content/help/contact.md
/example/content/help/help-me.md
/example/content/help/awesome.md

범주 내에서 원하는만큼 하위 폴더를 추가 할 수 있습니다.

카테고리에는 메타 정보가있을 수도 있습니다. meta카테고리 폴더에서 파일을 작성하십시오 . 다음 속성이 지원됩니다 (모두 선택 사항).

• 제목-폴더 이름을 기준으로 제목을 무시합니다.
• 정렬-카테고리 순서를 정렬 할 수 있으며 페이지 정렬과 같은 방식으로 작동합니다.
• ShowOnHome-참 / 거짓.

맞춤 홈페이지

사용자 정의 홈페이지를 추가 index.md하려면 example/content폴더에 마크 다운 파일을 추가하기 만하면됩니다 .

페이지 정렬

Raneto는 자동으로 페이지를 알파벳순으로 정렬하지만 Sort페이지 메타에 항목을 추가하여 수동 정렬을 적용 할 수 있습니다 . sort 값은 정수 여야합니다. 예를 들면 다음과 같습니다.

Sort: 7

이 페이지는 이제 정렬 값이 8 이상인 페이지 앞에 나타나지만 값이 6 이하인 페이지 뒤에 나타납니다.

템플릿 변경

HTML 또는 CSS에 익숙한 경우 Raneto 설치 모양을 쉽게 변경할 수 있습니다. Raneto는 JavaScript 편집 언어 인 Handlebars를 사용하여 HTML 편집을 모듈화합니다. themes/default폴더 에서 테마 파일을 찾을 수 있습니다 . Renato 템플릿 편집에 대한 자세한 내용을 보려면 도움말 섹션을 방문 하십시오 . 템플릿 편집을 마치면 응용 프로그램을 다시 시작해야합니다.