>  기사  >  백엔드 개발  >  PHP 마크다운 문서 관리 도구 구현 코드

PHP 마크다운 문서 관리 도구 구현 코드

小云云
小云云원래의
2018-02-01 14:14:442475검색

이 기사는 주로 PHP의 마크다운 문서 관리 도구 구현 코드를 공유합니다. 도움이 되기를 바랍니다.

주요 목표:

1. 여러 사람이 편집 가능

2. 브라우저에서 볼 수 있음

3. 다중 레벨 디렉토리 지원

5. 6.빠르고 편리합니다

저는 일을 시작하면서부터 PHP 개발에 종사해 왔습니다. 이전 작업부터 서버 측 인터페이스 작성까지 여러 인터페이스 문서 관리 도구나 시스템을 접하게 되었습니다. 간략한 설명:

showdoc, 포괄적이고 간결함, 사용자 및 권한 관리 기능 있음, 마크다운 지원, 단어 내보내기 지원, 다양한 문서 템플릿 있음, 디렉터리는 2단계 접기 지원

  1. confluence, 강력함 기능(권한 관리, 이메일 알림, 전체 텍스트 검색, 플러그인 관리 등), 무거운 유료 문서 관리

    시스템
  2. swagger, 협력하려면 코드에 많은 댓글을 작성해야 합니다

  3. readmine, confluence와 유사한 기능이 풍부하고 문서가 txt로 저장되어 변경 사항을 추적하고 전체 텍스트 검색이 가능하지만 문서 작성이 약간 번거롭습니다. 작업/버그 추적 관리 등에 적합합니다.

  4. gitbook, nodejs 설치, 마크다운 지원, npm 플러그인 지원, 왼쪽의 축소 가능한 디렉터리 트리가 필요합니다. 플러그인을 설치하고, 검색 플러그인도 설치할 수 있습니다. 디렉터리는 별도의 마크다운 파일입니다. 사용해보니 md에서 HTML로의 컴파일이 너무 느리다는 느낌이 들었습니다. (600개 이상의 문서를 컴파일하는데 25분 이상 소요되었습니다. 증분 컴파일이 있거나 컴파일 속도를 높이면 플러그인에 대한 조언 부탁드립니다

  5. 해결책:

git과 결합하면 가능하며, git의 권한 관리 기능을 사용할 수도 있습니다

  1. 마크다운을 HTML 파일로 컴파일하여 인트라넷에 배포해야 합니다

  2. 브라우저에서 볼 필요가 있기 때문에 여기서는 마침내 간단한 액세스, 깔끔한 인터페이스 및 종속성(jQuery에 의존하지 않음)을 갖춘 dtree.js를 선택했습니다.

  3. 이 함수는 루트 순서 탐색을 사용합니다. 다중 레벨 읽기 파일을 실현하기 위한 트리 알고리즘(재귀를 사용하지 않고 쓰기에 참여하는 것을 걱정하지 않음) dtree.js도 다중 레벨 디렉토리 접기를 지원합니다

  4. 여기에서 마침내 PHP 컴파일 도구를 선택했습니다 Segmentfault에서 정식으로 공개한 클래스입니다. (비슷한 PHP 클래스를 많이 참조하고 최적화했기 때문에 감사합니다~)

  5. 빠르면 600개 이상의 파일을 컴파일하는 데 2초 정도 걸립니다. 즉, 2초 정도 걸립니다. 허용되며 증분 컴파일을 지원합니다. 편리하다면 주로 디렉토리 자동 생성에 반영됩니다.

  6. 발생하는 문제:

  7. 증분 컴파일

먼저 md 파일을 HTML로 컴파일해야 하는지 판단하기 시작했고, md 파일 생성 시간과 마지막 수정 시간을 비교했습니다.

그러나 나중에 복사하고 이름을 바꾼 일부 파일에서는 이 방법이 작동하지 않는 것으로 나타났습니다.

마지막으로 중간 파일을 사용하여 컴파일된 파일의 시간을 기록한 후 max(생성 시간, 마지막 수정 시간)를 따라 컴파일이 필요한지 여부를 확인했습니다.

중복 파일 삭제

이후 사용 중에 발견되었습니다. 일부 md 파일이 삭제되었지만 최종 컴파일된 파일이 자동으로 삭제되지 않았습니다.

따라서 컴파일 중에 md 파일이 삭제됩니다. 최종 HTML 파일에 차이를 두고 중복된 HTML 파일을 삭제하세요

dtree.js를 통합


우선, dtree.js는 디렉토리를 표시하고 확장 및 축소와 상호 작용하기 위해 특정 필수 json 데이터가 필요합니다

또한 dtree.js의 글꼴은 상대적으로 작고 그림, 스타일 및 스크립트 파일은 모두 상대 경로입니다. 현재 도메인 이름을 기반으로 하는 절대 경로로 경로를 수정했습니다. 이렇게 하면 다른 도메인 이름에 배포할 때 수정할 필요가 없습니다. dtree.js 코드의 계층적 디렉터리의

어셈블리 그리고 HTML


어셈블리의 미화는 HTML 헤더, 바텀, 사이드바 등의 HTML 코드를 미리 작성해둔 뒤, 이 내용들을 컴파일된 내용에 스플라이스(splice)하고 마지막으로 해당 폴더에 넣어 미화하는 것입니다. 이는 주로 Segmentfault의 공식 컴파일 도구가 HTML 요소(예: 테이블, 코드)에 스타일을 추가하지 않기 때문입니다. 여기에서 관련 CSS 스타일을 찾아 다단계 디렉터리를 지원합니다.

이로 인해 비용도 발생합니다. 대학에서 동적 허프만 코딩을 작성할 때 트리 순회를 작성했습니다.

익숙하다고 생각했지만 마침내 밤 3시까지 걸렸다는 것을 누가 알았겠습니까? 완료하시겠습니까? 일단 작성되면 이 기능은 핵심 구성 요소 중 하나로 간주될 수 있습니다.


관련 권장사항:

Vuejs는 vue-markdown을 사용하여 주석 메서드를 렌더링합니다.


마크다운 미리보기 및 VSCode에서 미리보기 스타일 수정

마크다운 편집기에 대한 간략한 소개

위 내용은 PHP 마크다운 문서 관리 도구 구현 코드의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!

성명:
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.