From 9395c7b4a2079349fdb881a1f537af5b73eacfd2 Mon Sep 17 00:00:00 2001 From: Lars Thorsen Date: Mon, 25 Sep 2017 15:15:37 +0200 Subject: Remove unused files from the documentation build --- lib/erl_docgen/doc/src/fasc_dtds.xml | 116 ---------------------------------- lib/erl_docgen/doc/src/fascicules.xml | 15 ----- 2 files changed, 131 deletions(-) delete mode 100644 lib/erl_docgen/doc/src/fasc_dtds.xml delete mode 100644 lib/erl_docgen/doc/src/fascicules.xml (limited to 'lib/erl_docgen') diff --git a/lib/erl_docgen/doc/src/fasc_dtds.xml b/lib/erl_docgen/doc/src/fasc_dtds.xml deleted file mode 100644 index 390ae6c5d1..0000000000 --- a/lib/erl_docgen/doc/src/fasc_dtds.xml +++ /dev/null @@ -1,116 +0,0 @@ - - - - -
- - 20072016 - Ericsson AB. All Rights Reserved. - - - Licensed under the Apache License, Version 2.0 (the "License"); - you may not use this file except in compliance with the License. - You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. - - - - Fascicules DTDs - - - - - fasc_dtds.xml -
- -
- The fascicules DTD - -

The fascicules DTD is a special kind of DTD which can be - used to specify the different parts of the documentation, and - which one of those should be shown as default.

- -

Example:

- - 

-
-
-  
-    User's Guide
-  
-  
-    Reference Manual
-  
-  
-    Release Notes
-  
-
-    ]]>
- -

In the example, it is specified that the documentation for this - application consists of three parts: User's Guide, where - the "cover page" (with the two frames) is located in - part_frame.html, Reference Manual with the cover page - ref_man_frame.html and Release Notes with the cover page - part_notes_frame.html.

- -

As a result, at the top of the left frame in the generated HTML - documentation, there will be corresponding links to User's Guide, - Reference Manual and Release Notes.

- -

The attribute entry="yes" specifies that it is - the Reference Manual which should be shown as default. This means - that when generating the HTML files, application_frame.html - will be copied to index.html.

- - -

DocBuilder assumes that the XML file written according to - the fascicules DTD is called fascicules.xml.

- - -

This file is optional. If it does not exist, there are no links - to other parts of the documentation (as they are not known) in - the left frame, and no index.html is created.

-
- -
- - <fascicules> - -

Top level tag for the fascicules DTD.

- -

Contains one or more - <fascicule>.

-
- -
- - <fascicule> - -

Specifies properties for one "part" of the documentation for an - application.

- -

Contains plain text, the name of this part.

- -

The file attribute should specify the file name for - the corresponding part or application, without - the .xml extension.

- -

The href attribute should specify the file name for - the corresponding HTML cover page file, without the .html - extension.

- -

The optional entry="yes"|"no" attribute specifies if - the HTML cover page should be copied to index.html or - not. Default is "no".

-
- - diff --git a/lib/erl_docgen/doc/src/fascicules.xml b/lib/erl_docgen/doc/src/fascicules.xml deleted file mode 100644 index 154c8a3b6d..0000000000 --- a/lib/erl_docgen/doc/src/fascicules.xml +++ /dev/null @@ -1,15 +0,0 @@ - - - - - - User's Guide - - - Reference Manual - - - Release Notes - - - -- cgit v1.2.3 From d26187bcd2c12cfc126367f510a812b7b47899f2 Mon Sep 17 00:00:00 2001 From: Lars Thorsen Date: Wed, 4 Oct 2017 07:18:04 +0200 Subject: [erl_docgen] Change pdf to have the same style as html for code,warning,note --- lib/erl_docgen/priv/xsl/db_pdf.xsl | 70 ++++++++-------- lib/erl_docgen/priv/xsl/db_pdf_params.xsl | 128 +++++++++++++++--------------- 2 files changed, 101 insertions(+), 97 deletions(-) (limited to 'lib/erl_docgen') diff --git a/lib/erl_docgen/priv/xsl/db_pdf.xsl b/lib/erl_docgen/priv/xsl/db_pdf.xsl index 99263847fb..a9abd0270f 100644 --- a/lib/erl_docgen/priv/xsl/db_pdf.xsl +++ b/lib/erl_docgen/priv/xsl/db_pdf.xsl @@ -687,7 +687,7 @@ - - - - Note: - - - - + + + Note: + + + + + + - - - Warning: - - - - + + + Warning: + + + + + + - - - Do: - - - - + + + Do: + + + + + + - - - Don't: - - - - + + + Don't: + + + + + + diff --git a/lib/erl_docgen/priv/xsl/db_pdf_params.xsl b/lib/erl_docgen/priv/xsl/db_pdf_params.xsl index d9a150d2d9..99da29c2ac 100644 --- a/lib/erl_docgen/priv/xsl/db_pdf_params.xsl +++ b/lib/erl_docgen/priv/xsl/db_pdf_params.xsl @@ -1,9 +1,9 @@ - 210mm - @@ -248,86 +248,82 @@ - #e0e0ff + #f1f3f5 + solid + #dee2e6 + 0.3mm DejaVuSansMono, monospace 0.8em - auto + 3 preserve - 0em - 1em - 1em - 2em - 0.5em - 0.5em + 1.5mm + 1mm + 1mm + 1mm + 1mm + 1mm false preserve no-wrap + 0.5em + 0.5em - - 1em - - - - #d0fed0 - 1em - 2em - justify - 1em - 0.3em - 0.5em - 0.5em - 0.5em - 0.5em - always - - #ffd6d6 - 1em - 2em - justify - 1em - 0.3em - 0.5em - 0.5em - 0.5em - 0.5em - always + + 0.5em + solid + 0mm + #495057 + #2b8a3e + bold + #fefefe + 1mm + 0.5mm + 1mm + 1mm + 1mm + 1mm + 1.33em - - #d0fed0 - 1em - 2em - justify - 1em - 0.3em - 0.5em - 0.5em - 0.5em - 0.5em + always - - #ffd6d6 - 1em - 2em - justify - 1em - 0.3em - 0.5em - 0.5em - 0.5em - 0.5em - always + + 0.5em + solid + 0mm + #495057 + #c92a2a + bold + #fefefe + 1mm + 0.5mm + 1mm + 1mm + 1mm + 1mm + 1.33em - - 1.33em + + 0.5em + solid + 0mm + #495057 + #f8f9fa + justify + 1mm + 0.5mm + 1mm + 1mm + 1mm + 1mm @@ -354,7 +350,7 @@ always 0.25em - + 1.8em -- cgit v1.2.3 From a23e06da1942801b253e5e4f7461b318d8508ea6 Mon Sep 17 00:00:00 2001 From: Lars Thorsen Date: Mon, 9 Oct 2017 10:21:46 +0200 Subject: [erl_docgen] Fix spacing for code blocks --- lib/erl_docgen/priv/xsl/db_funcs.xsl | 136 +++++++++++++++++++++++++++++++++++ lib/erl_docgen/priv/xsl/db_html.xsl | 10 ++- lib/erl_docgen/priv/xsl/db_pdf.xsl | 17 ++++- 3 files changed, 159 insertions(+), 4 deletions(-) create mode 100644 lib/erl_docgen/priv/xsl/db_funcs.xsl (limited to 'lib/erl_docgen') diff --git a/lib/erl_docgen/priv/xsl/db_funcs.xsl b/lib/erl_docgen/priv/xsl/db_funcs.xsl new file mode 100644 index 0000000000..8178ce44fb --- /dev/null +++ b/lib/erl_docgen/priv/xsl/db_funcs.xsl @@ -0,0 +1,136 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/lib/erl_docgen/priv/xsl/db_html.xsl b/lib/erl_docgen/priv/xsl/db_html.xsl index a5e277aece..75614392fb 100644 --- a/lib/erl_docgen/priv/xsl/db_html.xsl +++ b/lib/erl_docgen/priv/xsl/db_html.xsl @@ -30,6 +30,7 @@ xmlns:fn="http://www.w3.org/2005/02/xpath-functions"> + @@ -1132,7 +1133,14 @@ -
+ + +
+ + +
+ + diff --git a/lib/erl_docgen/priv/xsl/db_pdf.xsl b/lib/erl_docgen/priv/xsl/db_pdf.xsl index a9abd0270f..46de66bcd8 100644 --- a/lib/erl_docgen/priv/xsl/db_pdf.xsl +++ b/lib/erl_docgen/priv/xsl/db_pdf.xsl @@ -23,12 +23,16 @@ + xmlns:func="http://exslt.org/functions" + xmlns:erl="http://erlang.org" + extension-element-prefixes="exsl func" + xmlns:fo="http://www.w3.org/1999/XSL/Format" + xmlns:fn="http://www.w3.org/2005/02/xpath-functions"> +