Changeset 120885


Ignore:
Timestamp:
Jun 10, 2014, 10:23:10 PM (5 years ago)
Author:
cal@…
Message:

guide: new, more macports-y layout to replace the somewhat oldstyle layout of the guide

Location:
trunk/doc-new
Files:
3 added
8 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc-new/Makefile

    r105466 r120885  
    6565        $(CP) $(GUIDE)/resources/$(STYLESHEET) $(GUIDE_RESULT)/$(STYLESHEET)
    6666        $(CP) $(GUIDE)/resources/images/* $(GUIDE_RESULT)/
     67        $(CP) $(GUIDE)/resources/*.js $(GUIDE_RESULT)/
    6768ifeq ($(UNAME), Linux)
    6869        $(LN) -sfn $(DOCBOOK) $(GUIDE)/resources/xsl
  • trunk/doc-new/guide/resources/base.xsl

    r38441 r120885  
    11<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version='1.0'>
    2 
    32    <!-- See http://docbook.sourceforge.net/release/xsl/current/doc/html/ for parameters -->
    43
     
    98    <xsl:param name="section.label.includes.component.label">1</xsl:param>
    109    <xsl:param name="profile.condition">noman</xsl:param>
     10    <xsl:param name="css.decoration">0</xsl:param>
    1111
    1212</xsl:stylesheet>
  • trunk/doc-new/guide/resources/chunk.xsl

    r48743 r120885  
    1111    <xsl:param name="chunk.section.depth">1</xsl:param>
    1212    <xsl:param name="use.id.as.filename">1</xsl:param>
     13    <xsl:template name="body.attributes">
     14        <xsl:attribute name="class">chunked</xsl:attribute>
     15    </xsl:template>
    1316
    1417    <!-- Set param for tabs.xml -->
  • trunk/doc-new/guide/resources/docbook.css

    r120837 r120885  
    77*/
    88
     9div.book {
     10        max-width: 1000px;
     11        margin: 0 auto;
     12}
     13
     14body.chunked div.navheader {
     15        max-width: 1000px;
     16        margin: 0 auto;
     17}
     18
     19body.chunked div.navfooter {
     20        margin-left: 183px;
     21        padding: 0 0 40px 10px;
     22}
     23
     24body.chunked div.navheader tr:first-child > th {
     25        margin: 0;
     26        background: url("https://www.macports.org/img/macports-logo-top.png") no-repeat;
     27        background-size: 183px 73px;
     28        padding-top: 18px;
     29        padding-left: 183px;
     30        padding-bottom: 35px;
     31        font-size: 32px;
     32        color: #0155cd;
     33        text-align: left;
     34}
     35
     36body.chunked div.titlepage h1 {
     37        display: none;
     38}
     39
     40div.book > div.titlepage {
     41        padding-bottom: 40px;
     42}
     43
     44body.chunked div.book > div.titlepage {
     45        max-width: 600px;
     46        margin: 0 auto;
     47}
     48
     49body.singlepage div.book > div.titlepage h1.title {
     50        margin: 0;
     51        display: block;
     52        height: 50px;
     53        background: url("https://www.macports.org/img/macports-logo-top.png") no-repeat;
     54        background-size: 183px 73px;
     55        padding-left: 183px;
     56        font-size: 32px;
     57        padding-top: 18px;
     58        color: #0155cd;
     59}
     60
     61body.singlepage div.book > div.titlepage h1.title span.application,
     62body.chunked div.navheader tr:first-child > th span.application {
     63        display: none;
     64}
     65
     66div.book > div.titlepage div.authorgroup {
     67        text-align: center;
     68}
     69
     70div.book > div.titlepage div.authorgroup div.author {
     71        display: inline;
     72        margin-left: 20px;
     73}
     74
     75div.book > div.titlepage div.authorgroup div.author h3.author {
     76        color: #000;
     77        display: inline;
     78}
     79
     80div.book > div.titlepage p.copyright {
     81        text-align: center;
     82        font-size: 90%;
     83        color: #333;
     84        margin: 0;
     85}
     86
     87body.chunked div.navheader hr,
     88body.chunked div.navfooter hr,
     89div.book > div.titlepage hr {
     90        display: none;
     91}
     92
     93body.chunked div.toc:first-child,
     94body.singlepage div.toc {
     95    width: 183px;
     96    background: url("https://www.macports.org/img/nav-header.png") top no-repeat #B1BACC;
     97    line-height: 1.4em;
     98        float: left;
     99}
     100
     101body.chunked div.toc:first-child {
     102        position: absolute;
     103        top: 130px;
     104        margin-bottom: 50px;
     105}
     106
     107body.chunked div.toc:first-child dl.toc,
     108body.singlepage div.toc dl.toc {
     109        padding: 16px 0;
     110        margin: 0;
     111        background: url("https://www.macports.org/img/nav-footer.png") bottom no-repeat;
     112}
     113
     114body.singlepage div.toc dl.toc {
     115        max-height: 90vh;
     116        overflow: auto;
     117}
     118
     119body.chunked div.toc:first-child dl.toc > dt,
     120body.singlepage div.toc dl.toc > dt {
     121        display: block;
     122    margin: 5px 0 0 0;
     123    padding: 0 12px;
     124    font: bold 100% "Lucida Grande", Helvetica, Arial, sans-serif;
     125}
     126
     127body.chunked div.toc:first-child dl.toc > dt a,
     128body.singlepage div.toc dl.toc > dt a {
     129        display: block;
     130        color: #fff;
     131        text-decoration: none;
     132}
     133
     134body.chunked div.toc:first-child dl.toc > dt a:hover,
     135body.singlepage div.toc dl.toc > dt a:hover {
     136        text-decoration: underline;
     137}
     138
     139body.chunked div.toc:first-child dl.toc dd,
     140body.singlepage div.toc dl.toc dd {
     141        margin: 0;
     142        padding: 0;
     143        font-size: 95%;
     144}
     145
     146body.chunked div.toc:first-child dl.toc dd dl dt,
     147body.singlepage div.toc dl.toc dd dl dt {
     148        display: block;
     149        padding: 0 12px 0 16px;
     150}
     151
     152body.chunked div.toc:first-child dl.toc dd dl dt a,
     153body.singlepage div.toc dl.toc dd dl dt a {
     154        display: block;
     155    text-decoration: none;
     156    color: #242933;
     157}
     158
     159body.chunked div.toc:first-child dl.toc dd dl dt a:hover,
     160body.singlepage div.toc dl.toc dd dl dt a:hover {
     161        text-decoration: underline;
     162}
     163
     164body.chunked div.book > div.chapter,
     165body.chunked div.book > div.section,
     166body.chunked div.book > div.refentry,
     167body.singlepage div.chapter {
     168        margin-left: 183px;
     169        padding: 0 0 40px 10px;
     170}
     171
     172div.chapter h1,
     173div.chapter h2,
     174div.chapter h3 {
     175        color: #314c72;
     176        margin: 0;
     177}
     178
     179div.chapter h1 {
     180        background: #8695b3;
     181        padding: .3em .5em .2em;
     182        font: bold 24px "Lucia Grande", Helvetica, Arial, sans-serif;
     183}
     184
     185div.chapter h2 {
     186        background: #8695b3;
     187        padding: .4em .5em .2em;
     188}
     189
     190div.chapter h1 a,
     191div.chapter h2 a {
     192        display: block;
     193        color: #fff;
     194        text-decoration: none;
     195}
     196
     197div.chapter h3 a,
     198div.chapter h4 a,
     199div.chapter h5 a {
     200        color: #314c72;
     201}
     202
     203div.chapter p {
     204        margin: 12px 0;
     205}
     206
     207div.note {
     208        margin: 0 .5in;
     209        padding: 0 15px 0;
     210        border-color: #8b1a1a;
     211        border-width: 0 3px;
     212        border-style: solid;
     213}
     214
     215div.note h3.title {
     216        color: #8B1A1A;
     217}
     218
     219div.screenshot div.mediaobject {
     220        text-align: center;
     221        margin: 12px 0;
     222}
     223
    9224div.mediaobject {
    10225        text-align: center;
    11         margin: auto;
    12         border: thin black inset;
     226        margin: 0;
     227}
     228
     229div.glossdiv {
     230        margin-top: 12px;
    13231}
    14232
     
    48266        border: thin black inset;
    49267        overflow: auto;
     268        padding: 2px 5px;
    50269}
    51270
     
    59278        border: thin black inset;
    60279        background-color: white;
    61 }
    62 
    63 div.screenshot div.mediaobject {
    64         text-align: center;
    65         margin: auto;
     280        overflow: auto;
     281        padding: 2px 5px;
    66282}
    67283
    68284body {
    69         font-family: Verdana, Arial, sans-serif;
    70         font-size: 14px;
    71         line-height: 1.4;
    72         color: #696969;
    73 }
    74 
    75 div.note h3.title {
    76         color: #C00;
    77 }
    78 
    79 .author {
    80         font-size: 14px;
    81         color: #6298E5;
    82         font-weight: bold;
    83 }
    84 
    85 .copyright {
    86         font-size: 12px;
    87         font-family: times;
    88 }
    89 
    90 div.book div.titlepage h1 {
    91         font-family: Verdana, Arial, Utopia, sans-serif;
    92         font-size: 24pt;
    93         color: black;
    94         font-weight: bold;
    95         text-align: left;
    96 }
    97 
    98 div.book div.titlepage h2 {
    99         font-family: Verdana, Arial, Utopia, sans-serif;
    100         font-size: 18pt;
    101         color: black;
    102         font-weight: bold;
    103         text-align: left;
    104 }
    105 
    106 div.section div.titlepage h2 {
    107         font-family: Verdana, Arial, Utopia, sans-serif;
    108         font-size: 16pt;
    109         color: black;
    110         text-align: left;
    111 }
    112 
    113 div.section div.titlepage h3 {
    114         font-family: Verdana, Arial, Utopia, sans-serif;
    115         font-size: 14pt;
    116         color: black;
    117         font-weight: bold;
    118         text-align: left;
    119 }
    120 
    121 div.section div.titlepage h4 {
    122         font-family: Verdana, Arial, Utopia, sans-serif;
    123         font-size: 12pt;
    124         color: black;
    125         font-weight: bold;
    126         text-align: left;
    127 }
    128 
    129 div.mediaobject {
    130         text-align: center;
    131         margin: auto;
    132 }
    133 
    134 p {
    135         margin-bottom: 14pt;
    136 }
    137 
    138 div.toc {
    139         border-width: 1px;
    140         border-color: black;
    141         border-style: solid;
    142 /*      background-color: #C2CAD8; Color of macosforge.org sidebar */
    143         background-color: #9FB6CD;
    144         background-repeat: no-repeat;
    145         background-position: center top;
    146 
    147         font-size: 10px;
    148         font-family: Verdana, Arial, sans-serif;
    149         color: black;
    150         left: 8px;
    151         width: 234px;
    152         padding-left: 2px;
    153         padding-top: 0px;
    154         height: 96%;
    155         float: left;
    156         overflow: auto;
    157         position: fixed;
    158         top: 12px;
    159 
    160 /* IE hack */
    161 
    162         position: expression("absolute");
    163         top: expression(document.body.scrollTop+this.offsetHeight-this.offsetHeight);
    164 }
    165 
    166 /* Definitions for non-Safari/non-IE toc sections */
    167 div.toc dt {
    168         font-size: 12px;
    169         line-height: 22px;
    170 }
    171 
    172 /* Definitions for non-Safari/non-IE toc subsections */
    173 div.toc dd dl dt {
    174         font-size: 11px;
    175         line-height: 14px;
    176 }
    177 
    178 /* Definitions for toc sections using Safari Stokely hack */
    179 html*.toc dt {
    180 /* Seen by Safari */
    181         font-size: 14px;
    182         line-height: 16px;
    183 /* Seen by IE */
    184         _font-size: 14px;
    185         _line-height: 22px;
    186 }
    187 
    188 /* Definitions for toc subsections using Safari Stokely hack */
    189 html*.toc dd dl dt {
    190 /* Seen by Safari */
    191         font-size: 11px;
    192         line-height: 13px;
    193         padding-bottom: 0px;
    194 /* Seen by IE */
    195         _font-size: 11px;
    196         _line-height: 14px;
    197         _padding-bottom: 0px;
    198 }
    199 
    200 /* TOC All Links */
    201 /* div.toc a:link { color: royalblue; } */
    202 /* div.toc a:hover { color: #D00; } */
    203 /* div.toc a:visited { color: black; text-decoration: none; } */
    204 
    205 
    206 /* TOC Section Links */
    207 div.toc dt a:link {
    208         color: #F4F6F8;
    209         text-decoration: none;
    210 }
    211 div.toc dt a:hover {
    212         color: gray;
    213 }
    214 div.toc dt a:visited {
    215         color: #F4F6F8;
    216         text-decoration: none;
    217 }
    218 
    219 
    220 /* TOC Subsubsection Links */
    221 div.toc dd dl dt a:link {
    222         color: black;
    223         text-decoration: none;
    224 }
    225 div.toc dd dl dt a:hover {
    226         color: gray;
    227 }
    228 div.toc dd dl dt a:visited {
    229         color: black;
    230         text-decoration: none;
    231 }
    232 
    233 div.book {
    234         margin-left: 247px;
    235 }
    236 
    237 /*
    238 div.toc:before {
    239         font-family: Palatino, Bookman, serif;
    240         font-size: 16px;
    241         font-weight: bold;
    242         text-align: center;
    243         display: block;
    244         color: black;
    245         content: "MacPorts Guide Contents";
    246 } */
     285    margin: 0;
     286    padding: 30px 40px;
     287    background: url("https://www.macports.org/img/top-backdrop.png") repeat-x #EDEDED;
     288    font: 12px Helvetica, Arial, sans-serif;
     289    line-height: 1.2em;
     290}
    247291
    248292/* Tabswitch for single page/chunked */
    249293div#tabswitch {
    250         position: absolute;
    251         top: 0;
     294        position: relative;
    252295        right: 0;
    253         background-color: #9FB6CD;
    254         border: 1px solid black;
     296        background-color: #8695B3;
     297        border: 1px solid #000;
     298        float: right;
     299}
     300
     301body.singlepage div#tabswitch {
     302        top: 75px;
     303}
     304
     305body.chunked div#tabswitch {
     306        top: -75px;
    255307}
    256308
    257309div#tabswitch a {
    258         padding: 0.3em;
     310        padding: .3em;
    259311        line-height: 2em;
    260312}
     
    265317
    266318div#tabswitch a:link {
    267         color: royalblue;
     319        color: #fff;
    268320        text-decoration: none;
    269321}
    270322
    271323div#tabswitch a:hover {
    272         color: gray;
     324        color: #242933;
    273325}
    274326
    275327div#tabswitch a:visited {
    276         color: black;
    277         text-decoration: none;
    278 }
     328        color: #fff;
     329        text-decoration: none;
     330}
  • trunk/doc-new/guide/resources/single-page.xsl

    r48743 r120885  
    44    <!-- Include tab switching for chunk and single-page -->
    55    <xsl:include href="tabs.xsl"/>
     6    <xsl:template name="body.attributes">
     7        <xsl:attribute name="class">singlepage</xsl:attribute>
     8    </xsl:template>
     9    <xsl:include href="sticky-sidebar.xsl"/>
    610
    711    <!-- See http://docbook.sourceforge.net/release/xsl/current/doc/html/ for parameters -->
  • trunk/doc-new/guide/resources/tabs.xsl

    r48743 r120885  
    11<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version='1.0'>
    2 
    3   <xsl:template name="user.header.content">
    4       <div id="tabswitch">
    5           <a href="/index.html">
    6               <xsl:if test="$chunkmode = 0">
    7                   <xsl:attribute name="class">selected</xsl:attribute>
    8               </xsl:if>
    9               Single Page
    10           </a>
    11           <a href="/chunked/index.html">
    12               <xsl:if test="$chunkmode = 1">
    13                   <xsl:attribute name="class">selected</xsl:attribute>
    14               </xsl:if>
    15               Chunked
    16           </a>
    17       </div>
    18   </xsl:template>
    19 
     2        <xsl:template name="user.header.content">
     3                <div class="book">
     4                        <div id="tabswitch">
     5                                <a href="/index.html">
     6                                        <xsl:if test="$chunkmode = 0">
     7                                                <xsl:attribute name="class">selected</xsl:attribute>
     8                                        </xsl:if>
     9                                        Single Page
     10                                </a>
     11                                <a href="/chunked/index.html">
     12                                        <xsl:if test="$chunkmode = 1">
     13                                                <xsl:attribute name="class">selected</xsl:attribute>
     14                                        </xsl:if>
     15                                        Chunked
     16                                </a>
     17                        </div>
     18                </div>
     19        </xsl:template>
    2020</xsl:stylesheet>
  • trunk/doc-new/guide/xml/guide.xml

    r76497 r120885  
    11<?xml version="1.0" encoding="UTF-8"?>
     2<!-- vim:ts=2:sts=2:sw=2:et
     3-->
    24<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    35"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
    46<book>
    5   <title>MacPorts Guide</title>
    6 
     7  <title>
     8    <application>MacPorts</application> Guide
     9  </title>
    710  <bookinfo>
    8     <author>
    9       <firstname>Mark</firstname>
    10 
    11       <surname>Duling</surname>
    12     </author>
    13 
    14     <author>
    15       <honorific>Dr</honorific>
    16 
    17       <firstname>Michael</firstname>
    18 
    19       <surname>Maibaum</surname>
    20 
    21       <othername role="mi">A</othername>
    22     </author>
    23 
    24     <author>
    25       <firstname>Will</firstname>
    26 
    27       <surname>Barton</surname>
    28     </author>
     11    <authorgroup>
     12      <author>
     13        <firstname>Mark</firstname>
     14        <surname>Duling</surname>
     15      </author>
     16      <author>
     17        <honorific>Dr</honorific>
     18        <firstname>Michael</firstname>
     19        <surname>Maibaum</surname>
     20        <othername role="mi">A</othername>
     21      </author>
     22      <author>
     23        <firstname>Will</firstname>
     24        <surname>Barton</surname>
     25      </author>
     26    </authorgroup>
    2927
    3028    <copyright>
    31       <year>2007-2011</year>
    32 
     29      <year>2007–2014</year>
    3330      <holder>The MacPorts Project</holder>
    3431    </copyright>
    3532
    3633    <copyright>
    37       <year>2002, 2003, 2004</year>
    38 
     34      <year>2002–2004</year>
    3935      <holder>The OpenDarwin Project</holder>
    4036    </copyright>
    41 
    42     <legalnotice>
    43       <para></para>
    44     </legalnotice>
    4537  </bookinfo>
    4638
    4739  <xi:include href="intro.xml"
    4840              xmlns:xi="http://www.w3.org/2001/XInclude" />
    49 
    5041  <xi:include href="installing.xml"
    5142              xmlns:xi="http://www.w3.org/2001/XInclude" />
    52 
    5343  <xi:include href="using.xml"
    5444              xmlns:xi="http://www.w3.org/2001/XInclude" />
    55 
    5645  <xi:include href="portfiledev.xml"
    5746              xmlns:xi="http://www.w3.org/2001/XInclude" />
    58 
    5947  <xi:include href="portfileref.xml"
    6048              xmlns:xi="http://www.w3.org/2001/XInclude" />
    61 
    6249  <xi:include href="internals.xml"
    6350              xmlns:xi="http://www.w3.org/2001/XInclude" />
    64 
    6551  <xi:include href="project.xml"
    6652              xmlns:xi="http://www.w3.org/2001/XInclude" />
    67 
    6853  <xi:include href="glossary.xml"
    6954              xmlns:xi="http://www.w3.org/2001/XInclude" />
    70 
    7155</book>
  • trunk/doc-new/toc-for-chunked.tcl

    r38440 r120885  
    77regexp {<div class="toc">.+?</div>} [read $file] replacement
    88close $file
    9 set replacement "<body>$replacement<div class=\"book\">"
     9set replacement "<body\\1><div class=\"book\">$replacement"
    1010
    1111# Add the table of contents to all other html files.
    1212foreach path [glob -directory [lindex $argv 0] {*.html}] {
    13     if {$path == "index.html"} {
     13    if {[file tail $path] == "index.html"} {
    1414        continue
    1515    }
     
    1717    set file [open $path r+]
    1818    set data [read $file]
    19     regsub {<body>} $data $replacement data
     19    regsub {<body([^>]+)>} $data $replacement data
    2020    regsub {</body>} $data {</div></body>} data
    2121    seek $file 0
Note: See TracChangeset for help on using the changeset viewer.