DDoc 출력의 더 풍부한 색상 및 조판

DDoc으로 표시된 D 프로그램에서 생성 된 HTML 페이지를 더욱 풍부한 색상 및 유형 설정으로 만들 수 있습니까? 기본값은 흑백입니다.DDoc 출력의 더 풍부한 색상 및 조판

나는 현재

dmd -debug -gc -unittest -D -Dd$OUTPUT_DIR

출처

2013-09-07 Nordlöw

아니라 DMD를 호출하고있어, 당신은 아마 세부 사항의 일부를 얻을 수 http://dlang.org/ddoc.html을 읽어해야하지만, 궁극적으로 무엇을 당신이 필요로하는 것은이를 제시하는 방법에 대해 설명 CSS 파일입니다 페이지. 이는 DDOC 매크로를 통해 설정할 수 있습니다.

나는 dlang.org를위한 코드를 포함하고있는 https://github.com/D-Programming-Language/dlang.org을 살펴볼 것을 제안합니다 - ddoc 내용 포함. 특히, (그들은 모두 std.ddoc 참조하는대로) CSS를, 이미지 및 JS 폴더와 함께 std.ddoc를 잡고 싶다. 그런 다음 std.ddoc을 문서 빌드의 일부로 dmd에 제공하고 설명서의 상위 디렉토리에 해당 폴더가 있으면 생성 된 문서가 dlang.org의 설명서처럼 보입니다. 폴더를 다른 위치에 두려면 다음 경로를 사용하여 std.ddoc 경로를 조정하십시오.

설명서의 모양을 변경하려면 std.ddoc 및 그에 따라 css 파일을 조정하십시오. 이 시점에서 html과 css를 다루므로, 매크로를 사용하여 매크로에 필요한 변경을 수행하는 방법을 알아야합니다. std.ddoc 또는 css 파일 자체. 물론 js 파일로 무엇이든하고 싶다면 자바 스크립트를 알아야합니다. 원할 경우 모든 j 및 이미지를 제거 할 수 있습니다. 그것들은 dlang.org에서 사용되는 것일 뿐이지 만, HTML과 친구들이 어떻게 해야할지 알기 위해 어떤 단서를 가지고 있어야합니다. 나는 그 어느 것에도 정통하지는 않기 때문에 문서를 만들 때 일반적으로 dlang.org가 사용하는 것에 최소한의 변화만을주었습니다. 그러나 제가 일반적으로 찾고 있었던 것은 더 읽기 쉬운 색상을 얻는 것입니다 구체적인 것보다 기본값보다

내가 더 구체적이거나 그보다 도움이 될 수는 없지만, 내가 그걸로 끝낸 것은 그야말로 dlang.org와 비슷한 페이지를 얻을 수있을 정도로 비틀 거린다. 왜냐하면 나는 웹 개발. 다행히도 이것은 올바른 방향으로 당신을 가리킬 것입니다.

당신이 조사하고 싶은 다른 정보는 ddox입니다.이 정보는 ddoc 주석보다 dmd보다 나은 문서를 생성하는 데 사용됩니다. dlang.org는 비교적 가까운 장래에 ddox에서 생성 된 문서를 사용하기 시작할 것입니다. (일부 세부 사항은 여전히 분류해야하므로 정확한 시점은 알 수 없지만 현재 계획이 있습니다.) 따라서 ddox를 사용하면 궁극적으로 dmd를 사용하여 문서를 생성하는 것보다 더 일반적인 것이 될 수 있습니다.

출처

2013-09-07 11:48:04

클래스 이름과 ID를 사용하도록 새 ddoc 매크로를 재정의하거나 만들 수있는 .ddoc 구성 파일을 직접 만들 수 있습니다. 그런 다음 CSS를 사용하여 페이지 스타일을 지정할 수 있습니다.

샘플.경우이 파일은 (윈도우의 경우) 어딘가에 저장되고 sc.ini 파일에 추가해야

DDOC = <!DOCTYPE HTML> 
<html> 
    <head> 
     <meta http-equiv="content-type" content="text/html; charset=utf-8" /> 
     <link type="text/css" href="theme.css" rel="stylesheet" media="all" /> 
     <title>$(TITLE)</title> 
    </head> 
    <body> 
     <h1>$(TITLE)</h1> 
     $(BODY) 
    </body> 
</html> 
H2 = <h2>$0</h2> 
H3 = <h3>$0</h3> 
STRONG = <strong>$0</strong> 
EM = <em>$0</em> 
DDOC_DECL = $(H2 $0) 
DDOC_DECL_DD = <div class="declaration-description">$0</div> 

DDOC_CLASS_MEMBERS = <div class="class-members">$0</div> 
DDOC_SUMMARY = $(P $0) 
DDOC_DESCRIPTION = $(P $0) 

DDOC_MEMBERS = <div class="members">$0</div> 
DDOC_ENUM_MEMBERS = <div class="enum-members">$0</div> 
DDOC_MODULE_MEMBERS = <div class="module-members">$0</div> 
DDOC_STRUCT_MEMBERS = <div class="struct-members">$0</div> 
DDOC_TEMPLATE_MEMBERS = <div class="template-members">$0</div>

또는 dmd.conf 파일 (: 사용자 정의 CSS를 포함 ddoc 파일은 head HTML 섹션에서 theme.css 파일을 주목하라 이 같은 맥/리눅스)의 : 다음

DDOCFILE=myproject.ddoc

당신이 -D를 사용하여 컴파일 다음 번에, HTML 대신 내장 된 물건과 비올라의 사용자 정의 ddoc 매크로에서 읽어

, 당신은 스타일 수 클래스 이름을 가지고 id는 CSS와 함께 사용합니다. http://htmlpreview.github.io/?https://github.com/kalekold/dunit/master/docs/dunit/toolkit.html

HTML 파일 : https://github.com/nomad-software/dunit/tree/master/docs/dunit

전체 ddoc 매크로 옵션 여기에서 찾을 수 있습니다 : http://dlang.org/ddoc.html

사용자 정의 스타일 시트 및 매크로를 사용하여 꽤 문서의 미리보기입니다

출처

2014-01-01 14:42:01

DDoc 출력의 더 풍부한 색상 및 조판

답변

관련 문제