이 기사는 주로 PHP의 마크다운 문서 관리 도구 구현 코드를 공유합니다. 도움이 되기를 바랍니다.
주요 목표:
1. 여러 사람이 편집 가능
2. 브라우저에서 볼 수 있음
3. 다중 레벨 디렉토리 지원
5. 6.빠르고 편리합니다
저는 일을 시작하면서부터 PHP 개발에 종사해 왔습니다. 이전 작업부터 서버 측 인터페이스 작성까지 여러 인터페이스 문서 관리 도구나 시스템을 접하게 되었습니다. 간략한 설명:
showdoc, 포괄적이고 간결함, 사용자 및 권한 관리 기능 있음, 마크다운 지원, 단어 내보내기 지원, 다양한 문서 템플릿 있음, 디렉터리는 2단계 접기 지원
confluence, 강력함 기능(권한 관리, 이메일 알림, 전체 텍스트 검색, 플러그인 관리 등), 무거운 유료 문서 관리
시스템swagger, 협력하려면 코드에 많은 댓글을 작성해야 합니다
readmine, confluence와 유사한 기능이 풍부하고 문서가 txt로 저장되어 변경 사항을 추적하고 전체 텍스트 검색이 가능하지만 문서 작성이 약간 번거롭습니다. 작업/버그 추적 관리 등에 적합합니다.
gitbook, nodejs 설치, 마크다운 지원, npm 플러그인 지원, 왼쪽의 축소 가능한 디렉터리 트리가 필요합니다. 플러그인을 설치하고, 검색 플러그인도 설치할 수 있습니다. 디렉터리는 별도의 마크다운 파일입니다. 사용해보니 md에서 HTML로의 컴파일이 너무 느리다는 느낌이 들었습니다. (600개 이상의 문서를 컴파일하는데 25분 이상 소요되었습니다. 증분 컴파일이 있거나 컴파일 속도를 높이면 플러그인에 대한 조언 부탁드립니다
해결책:
마크다운을 HTML 파일로 컴파일하여 인트라넷에 배포해야 합니다
브라우저에서 볼 필요가 있기 때문에 여기서는 마침내 간단한 액세스, 깔끔한 인터페이스 및 종속성(jQuery에 의존하지 않음)을 갖춘 dtree.js를 선택했습니다.
이 함수는 루트 순서 탐색을 사용합니다. 다중 레벨 읽기 파일을 실현하기 위한 트리 알고리즘(재귀를 사용하지 않고 쓰기에 참여하는 것을 걱정하지 않음) dtree.js도 다중 레벨 디렉토리 접기를 지원합니다
여기에서 마침내 PHP 컴파일 도구를 선택했습니다 Segmentfault에서 정식으로 공개한 클래스입니다. (비슷한 PHP 클래스를 많이 참조하고 최적화했기 때문에 감사합니다~)
빠르면 600개 이상의 파일을 컴파일하는 데 2초 정도 걸립니다. 즉, 2초 정도 걸립니다. 허용되며 증분 컴파일을 지원합니다. 편리하다면 주로 디렉토리 자동 생성에 반영됩니다.
발생하는 문제:
중복 파일 삭제
이후 사용 중에 발견되었습니다. 일부 md 파일이 삭제되었지만 최종 컴파일된 파일이 자동으로 삭제되지 않았습니다.
우선, dtree.js는 디렉토리를 표시하고 확장 및 축소와 상호 작용하기 위해 특정 필수 json 데이터가 필요합니다
어셈블리의 미화는 HTML 헤더, 바텀, 사이드바 등의 HTML 코드를 미리 작성해둔 뒤, 이 내용들을 컴파일된 내용에 스플라이스(splice)하고 마지막으로 해당 폴더에 넣어 미화하는 것입니다. 이는 주로 Segmentfault의 공식 컴파일 도구가 HTML 요소(예: 테이블, 코드)에 스타일을 추가하지 않기 때문입니다. 여기에서 관련 CSS 스타일을 찾아 다단계 디렉터리를 지원합니다.
관련 권장사항:
마크다운 미리보기 및 VSCode에서 미리보기 스타일 수정
위 내용은 PHP 마크다운 문서 관리 도구 구현 코드의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!