summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSverker Eriksson <sverker@erlang.org>2020-05-28 18:54:08 +0200
committerSverker Eriksson <sverker@erlang.org>2020-06-11 12:56:01 +0200
commit72db9b5e5adff301ea097d6d42cd960eccf8e19a (patch)
treeaa1ed49fb5ed31b2ec8817e7501080021eadbb6d
parentc8de0bf96c26883fb1f6811e4cc08da48d844765 (diff)
downloaderlang-72db9b5e5adff301ea097d6d42cd960eccf8e19a.tar.gz
Refactor HTML layout to not use width > 100%
which causes problem with "overflow-x: hidden" In short: Increased the width +10em to fit the "since" versions while retaining the right margin of other text.
-rw-r--r--lib/erl_docgen/priv/css/otp_doc.css33
-rw-r--r--lib/erl_docgen/priv/xsl/db_html.xsl50
-rw-r--r--system/doc/top/templates/index.html.src2
3 files changed, 65 insertions, 20 deletions
diff --git a/lib/erl_docgen/priv/css/otp_doc.css b/lib/erl_docgen/priv/css/otp_doc.css
index 17d9f8dd56..cac150b19c 100644
--- a/lib/erl_docgen/priv/css/otp_doc.css
+++ b/lib/erl_docgen/priv/css/otp_doc.css
@@ -49,9 +49,14 @@ a:visited { color: #1b6ec2; text-decoration: none }
border-right: 1px solid #ccc;
}
+.leftnav-tube
+{
+ margin: 15px;
+}
+
#content {
margin-left: 340px; /* set left value to WidthOfFrameDiv */
- max-width: 42em;
+ max-width: 52em;
}
.frontpage
@@ -61,7 +66,8 @@ a:visited { color: #1b6ec2; text-decoration: none }
.innertube
{
- margin: 15px; /* Magins for inner DIV inside each DIV (to provide padding) */
+ margin-left: 15px; /* Magins for inner DIV inside each DIV (to provide padding) */
+ margin-right: 11em;
}
.footer
@@ -75,7 +81,7 @@ a:visited { color: #1b6ec2; text-decoration: none }
/* Invisible table for function specs,
* just to get since-version out in right margin */
.func-table, .func-tr, .func-td, .cfunc-td, .func-since-td {
- width: 200%;
+ width: 100%;
border: 0;
padding: 0;
margin: 0;
@@ -86,18 +92,18 @@ a:visited { color: #1b6ec2; text-decoration: none }
}
.func-td {
- width: 50%;
+ width: 38em;
}
.cfunc-td {
- width: 50%;
- padding-left: 100px;
- text-indent: -100px;
+ width: 31em;
+ padding-left: 7em;
+ text-indent: -7em;
}
.func-since-td {
- width: 50%;
- padding-left: 1em
+ width: auto;
+ padding-left: 1em;
}
.func-td:hover {
@@ -187,10 +193,17 @@ pre {
}
-.exports-body, .data-types-body, .REFBODY{
+.data-types-body, .REFBODY{
margin-left: 2em;
}
.REFTYPES { margin-left: 1.5em }
+.exports-body {
+ margin-left: 3em;
+}
+.exports-tube
+{
+ margin-right: 11em;
+}
footer { }
diff --git a/lib/erl_docgen/priv/xsl/db_html.xsl b/lib/erl_docgen/priv/xsl/db_html.xsl
index c14e7c9a71..f495bdd371 100644
--- a/lib/erl_docgen/priv/xsl/db_html.xsl
+++ b/lib/erl_docgen/priv/xsl/db_html.xsl
@@ -445,10 +445,12 @@
<!-- Datatypes -->
<xsl:template match="datatypes">
+ <div class="innertube">
<xsl:call-template name="h3_title_link">
<xsl:with-param name="title">Data Types</xsl:with-param>
</xsl:call-template>
<xsl:apply-templates/>
+ </div>
</xsl:template>
<!-- Datatype Title, is the really needed? not used by anything -->
@@ -801,13 +803,11 @@
</xsl:call-template>
<div id="content">
- <div class="innertube">
<!-- Insert the node-specific content -->
<xsl:call-template name="content">
<xsl:with-param name="chapnum" select="$chapnum"/>
</xsl:call-template>
- </div>
<div class="footer">
<hr/>
@@ -837,6 +837,7 @@
<xsl:variable name="lname"><xsl:value-of select="local-name()"/></xsl:variable>
+ <div class="innertube">
<xsl:if test="$lname = 'releasenotes'">
<!-- .../part -->
<xsl:call-template name="releasenotes.content" />
@@ -859,6 +860,7 @@
<!-- .../application -->
<xsl:call-template name="app.content" />
</xsl:if>
+ </div>
<xsl:if test="$lname = 'erlref' or $lname = 'cref' or $lname= 'comref' or $lname= 'fileref' or $lname= 'appref'">
<!-- .../application/*ref -->
<xsl:comment> refpage </xsl:comment>
@@ -1054,6 +1056,7 @@
<!-- *ref/Section -->
<xsl:template match="erlref/section|cref/section|comref/section|fileref/section|appref/section|funcs/fsdescription">
<xsl:param name="chapnum"/>
+ <div class="innertube">
<h3>
<xsl:for-each select="marker">
<xsl:call-template name="marker-before-title"/>
@@ -1067,6 +1070,7 @@
<xsl:with-param name="chapnum" select="$chapnum"/>
</xsl:apply-templates>
</div>
+ </div>
</xsl:template>
<!-- *ref/Subsection -->
@@ -1378,7 +1382,7 @@
<xsl:param name="chapnum"/>
<div id="leftnav">
- <div class="innertube">
+ <div class="leftnav-tube">
<xsl:call-template name="erlang_logo"/>
@@ -1406,7 +1410,7 @@
<xsl:template name="menu.internal.ref">
<xsl:param name="curModule"/>
<div id="leftnav">
- <div class="innertube">
+ <div class="leftnav-tube">
<xsl:call-template name="erlang_logo"/>
@@ -1473,7 +1477,7 @@
<xsl:param name="chapnum"/>
<div id="leftnav">
- <div class="innertube">
+ <div class="leftnav-tube">
<xsl:call-template name="erlang_logo"/>
@@ -1634,7 +1638,7 @@
<xsl:template name="menu.ref">
<xsl:param name="curModule"/>
<div id="leftnav">
- <div class="innertube">
+ <div class="leftnav-tube">
<xsl:call-template name="erlang_logo"/>
@@ -1964,6 +1968,7 @@
<xsl:template name="ref.content">
<xsl:param name="partnum"/>
+ <div class="innertube">
<center>
<h1>
<xsl:choose>
@@ -1985,17 +1990,18 @@
</xsl:choose>
</h1>
</center>
+ </div>
<xsl:apply-templates>
<xsl:with-param name="partnum" select="$partnum"/>
</xsl:apply-templates>
-
</xsl:template>
<!-- Module -->
<xsl:template match="module">
<xsl:param name="partnum"/>
+ <div class="innertube">
<xsl:call-template name="h3_title_link">
<xsl:with-param name="title">Module</xsl:with-param>
</xsl:call-template>
@@ -2004,12 +2010,14 @@
<xsl:with-param name="partnum" select="$partnum"/>
</xsl:apply-templates>
</div>
+ </div>
</xsl:template>
<!-- Modulesummary -->
<xsl:template match="modulesummary">
<xsl:param name="partnum"/>
+ <div class="innertube">
<xsl:call-template name="h3_title_link">
<xsl:with-param name="title">Module Summary</xsl:with-param>
</xsl:call-template>
@@ -2028,11 +2036,13 @@
<xsl:value-of select="../module/@since"/>.
</div>
</xsl:if>
+ </div>
</xsl:template>
<!-- Lib -->
<xsl:template match="lib">
<xsl:param name="partnum"/>
+ <div class="innertube">
<xsl:call-template name="h3_title_link">
<xsl:with-param name="title">C Library</xsl:with-param>
</xsl:call-template>
@@ -2041,12 +2051,14 @@
<xsl:with-param name="partnum" select="$partnum"/>
</xsl:apply-templates>
</div>
+ </div>
</xsl:template>
<!-- Libsummary -->
<xsl:template match="libsummary">
<xsl:param name="partnum"/>
+ <div class="innertube">
<xsl:call-template name="h3_title_link">
<xsl:with-param name="title">Library Summary</xsl:with-param>
</xsl:call-template>
@@ -2055,11 +2067,13 @@
<xsl:with-param name="partnum" select="$partnum"/>
</xsl:apply-templates>
</div>
+ </div>
</xsl:template>
<!-- Com -->
<xsl:template match="com">
<xsl:param name="partnum"/>
+ <div class="innertube">
<xsl:call-template name="h3_title_link">
<xsl:with-param name="title">Command</xsl:with-param>
</xsl:call-template>
@@ -2068,12 +2082,14 @@
<xsl:with-param name="partnum" select="$partnum"/>
</xsl:apply-templates>
</div>
+ </div>
</xsl:template>
<!-- Comsummary -->
<xsl:template match="comsummary">
<xsl:param name="partnum"/>
+ <div class="innertube">
<xsl:call-template name="h3_title_link">
<xsl:with-param name="title">Command Summary</xsl:with-param>
</xsl:call-template>
@@ -2082,11 +2098,13 @@
<xsl:with-param name="partnum" select="$partnum"/>
</xsl:apply-templates>
</div>
+ </div>
</xsl:template>
<!-- File -->
<xsl:template match="file">
<xsl:param name="partnum"/>
+ <div class="innertube">
<xsl:call-template name="h3_title_link">
<xsl:with-param name="title">File</xsl:with-param>
</xsl:call-template>
@@ -2095,12 +2113,14 @@
<xsl:with-param name="partnum" select="$partnum"/>
</xsl:apply-templates>
</div>
+ </div>
</xsl:template>
<!-- Filesummary -->
<xsl:template match="filesummary">
<xsl:param name="partnum"/>
+ <div class="innertube">
<xsl:call-template name="h3_title_link">
<xsl:with-param name="title">File Summary</xsl:with-param>
</xsl:call-template>
@@ -2109,12 +2129,14 @@
<xsl:with-param name="partnum" select="$partnum"/>
</xsl:apply-templates>
</div>
+ </div>
</xsl:template>
<!-- App -->
<xsl:template match="app">
<xsl:param name="partnum"/>
+ <div class="innertube">
<xsl:call-template name="h3_title_link">
<xsl:with-param name="title">Application</xsl:with-param>
</xsl:call-template>
@@ -2123,12 +2145,14 @@
<xsl:with-param name="partnum" select="$partnum"/>
</xsl:apply-templates>
</div>
+ </div>
</xsl:template>
<!-- Appsummary -->
<xsl:template match="appsummary">
<xsl:param name="partnum"/>
+ <div class="innertube">
<xsl:call-template name="h3_title_link">
<xsl:with-param name="title">Application Summary</xsl:with-param>
</xsl:call-template>
@@ -2137,12 +2161,15 @@
<xsl:with-param name="partnum" select="$partnum"/>
</xsl:apply-templates>
</div>
+ </div>
</xsl:template>
<!-- Description -->
<xsl:template match="description">
<xsl:param name="partnum"/>
- <xsl:call-template name="h3_title_link">
+
+ <div class="innertube">
+ <xsl:call-template name="h3_title_link">
<xsl:with-param name="title">Description</xsl:with-param>
</xsl:call-template>
<div class="REFBODY description-body">
@@ -2152,6 +2179,7 @@
</xsl:apply-templates>
</p>
</div>
+ </div>
</xsl:template>
<!-- Funcs -->
@@ -2162,9 +2190,11 @@
<xsl:with-param name="partnum" select="$partnum"/>
</xsl:apply-templates>
+ <div class="innertube">
<xsl:call-template name="h3_title_link">
<xsl:with-param name="title">Exports</xsl:with-param>
</xsl:call-template>
+ </div>
<div class="exports-body">
<xsl:apply-templates select="func">
@@ -2183,9 +2213,11 @@
select="name[string-length(@arity) > 0 and position()=last()]"
mode="types"/>
+ <div class="exports-tube">
<xsl:apply-templates select="fsummary|type|desc">
<xsl:with-param name="partnum" select="$partnum"/>
</xsl:apply-templates>
+ </div>
</xsl:template>
@@ -2622,7 +2654,7 @@
<xsl:param name="chapnum"/>
<div id="leftnav">
- <div class="innertube">
+ <div class="leftnav-tube">
<xsl:call-template name="erlang_logo"/>
diff --git a/system/doc/top/templates/index.html.src b/system/doc/top/templates/index.html.src
index 5507d4dfe4..ab75ed0478 100644
--- a/system/doc/top/templates/index.html.src
+++ b/system/doc/top/templates/index.html.src
@@ -33,7 +33,7 @@ limitations under the License.
<div id="container">
<div id="leftnav">
-<div class="innertube">
+<div class="leftnav-tube">
<div class="erlang-logo-wrapper">
<img alt="Erlang logo" src="erlang-logo.png" class="erlang-logo"/ >
</div>