2

개인적인 "사용법"가이드를 작성하면서 저도 공부하면서 저널을 저널링하고 보관하고 있습니다.RST의 코드 블록에 복사 버튼을 추가하는 방법/문서 읽기

필자는 코드 길이가 너무 길어서 코드 길이가 너무 길어서 전체 페이지를 강조 표시하지 않고 블록 만 강조 표시하거나 불만을 표시하려고 항상 좌절했습니다.

그래서, 내 질문은, rst (reStructuredText) .. code-block:: 's의 자동 강조를위한 추가 기능 또는 copy 버튼에 추가하는 방법이있다거나 자동으로 사용자의 클립 보드에 텍스트를 추가? 아니면 코드 블록에서 빌드하고 참조해야 할 html 리터럴 유형의 코드일까요? 그렇다면 그와 비슷한 어떤 것이 좋을까요?

답변

1

스핑크스 프로젝트에서 HTML 페이지의 표시는 템플릿 언어 (기본적으로 Jinja2)를 사용하여 제어됩니다. 따라서 HTML 템플릿 파일에 Javascript를 추가하여 대화 형 페이지를 대화식으로 만들 수 있으며 Sphinx가 특정 템플릿 파일을 사용하여 페이지를 렌더링 할 때 삽입됩니다.

은 아마 {% extends "basic/layout.html" %}로 시작하는 파일을 원하는, 그래서 서로를 확장 할 수 있습니다 conf.py

신사 템플릿에 templates_path를 검색하여 템플릿 디렉토리를 찾습니다. 당신이 어디에 당신이 당신의 변화를 만들고 싶어 확장의 순서로 추적하면

, 당신은 결합해야합니다 :

  • 이 (일반적으로 메인 블록)을 적용 할 페이지의 섹션
  • 코드 블록 (예 : 광산은 class=highlight)의 클래스가있는 CSS입니다. 버튼을 만들고 클립 보드 (예. https://clipboardjs.com/)

다음에 쓰기, 로컬 스핑크스 프로젝트를 빌드하는 자바 스크립트 스 니펫 .css 파일이 아니라 문서에있을 수 있습니다/소스/_static/

  • A (make html) 당신이 전화를 걸고 독서실로 가져 오기 전까지