이 프로젝트는 PHP를 사용하여 Markdown 파일을 동적으로 제공하는 플랫 파일 웹 사이트입니다. 웹 사이트 콘텐츠 관리에는 많은 옵션이 있지만 개인 웹 사이트 의이 방법을 선호합니다.
index.md
로 폴더를 만듭니다![](TOC)
사용하여 목차를 추가하십시오.![](YouTubeURL)
사용하여 YouTube 동영상을 포함 1 단계 : git
사용 하여이 리브를 웹 폴더 외부에서 복제하십시오. /var/www/md2html
제안합니다
2 단계 : 리소스 폴더를 웹 액세스 가능한 URL에 연결
ln -ls /var/www/md2html/resources /var/www/html/md2html-resources
3 단계 : QuickStart 데모 폴더를 웹 폴더에 복사하면 사이트가 생중계됩니다!
4 단계 : 새 페이지를 만들려면 index.md
로 하위 폴더를 만듭니다.
이 저장소에는 준비된 데모 사이트가 있습니다.
docker-compose up -d
실행하고 http : // localhost : 8081로 이동하십시오
Markdown 파일에는 템플릿에서 {{mustache}}
텍스트가 무엇인지 사용자 정의하기 위해 Front Matter가 포함 된 옵션 헤더가있을 수 있습니다. 기본 교체는 settings.php
에 정의되어 있으며 헤더에 정의 된 값은 설정 파일에 정의 된 값을 무시합니다.
---
title: this text becomes the title element in the header
description: this text becomes header metadata for search engines to display
---
# My Markdown Article
The rest of the ***Markdown*** text goes here...
이 저장소는 .htaccess
사용하여 APACHE (mod_rewrite 포함)를 알리기 위해 index.md
가 포함 된 폴더로 요청을 로컬 PHP 스크립트로 처리하기 위해 요청을 처리합니다. Apache 또는 Mod_rewrite를 사용하지 않으면 디렉토리 인덱스 요청을 비슷하게 라우팅하는 데 필요한 시스템을 사용하십시오.
Flat-File 웹 사이트는 git
사용하여 웹 서버에 복제 할 수 있으며 PHP는 git pull
실행하여 컨텐츠를 업데이트 할 수 있습니다. 새 커밋이 리포지토리에 푸시 될 때마다 PHP 업데이트 스크립트를 실행하는 HTTP 요청을 만들기 위해 GitHub 조치를 구성함으로써 웹 사이트를 GitHub 리포지토리와 지속적으로 자동으로 유지할 수 있습니다.
wwwroot
웹 액세스 가능한 경로에 상징적으로 연결합니다API_KEY
만듭니다api.key
에 키를 저장하십시오 (CHMOD 400
)API_KEY
베어러 토큰으로 사용하여 새 커밋을 푸시 할 때 http 요청 deploy.php
에 GitHub 조치를 구성하십시오 (deploy.yml 참조). 이 PHP 기반 시스템을 몇 달 동안 사용한 후 100 페이지가있는 대형 사이트에서는 즐기기 위해 성장했지만 몇 페이지 만있는 매우 작은 사이트의 경우 약간의 페이지 편집을하기 위해 Docker 인스턴스를 발사하는 것이 번거 롭습니다. .
나는이 요구를 충족시키기 위해 Palila를 만들었습니다 - Index.md를 index.html로 변환하는 작은 파이썬 스크립트로 (편집 할 때) 또는 원격으로 (배포 할 때).