Trang chủ Khám phá Trợ giúp
Đăng nhập
RONCC
/
Geografic-Information-System
Xem 1
Star 0
Fork 0
Các tập tin Các vấn đề 0 Yêu cầu khéo về 0 Wiki
Browse Source

doc: new style for manual pages (co-author: neteler)

* page in block with given width to have shorter lines on wide screens (selected width 700px)
* improved style for TOC: smaller spacing, links green, underlined on hover, heading, unfolds on hover (might not be need with narrow content), transparent when folded
* all links green
* headings has different sizes (h2 and h3 had the same size - large)
* the whole page must be in containder div for narrow content to work


git-svn-id: https://svn.osgeo.org/grass/grass/trunk@61935 15284696-431f-4ddb-bdfa-cd5b030d7da7
Vaclav Petras 10 năm trước cách đây
mục cha
2dcf5a9907
commit
56ffcf6ec8
4 tập tin đã thay đổi với 82 bổ sung và 10 xóa
View chưa được định nghĩa Hiển thị tình trạng sai khác
  1. 2 1
      lib/gis/parser_html.c
  2. 8 2
      man/build_html.py
  3. 67 7
      man/grassdocs.css
  4. 5 0
      tools/mkhtml.py

+ 2 - 1
lib/gis/parser_html.c
Xem Tập Tin 

@@ -49,7 +49,8 @@ void G__usage_html(void)
 
     fprintf(stdout,
 
     fprintf(stdout,
 
 	    "<link rel=\"stylesheet\" href=\"grassdocs.css\" type=\"text/css\">\n");
 
 	    "<link rel=\"stylesheet\" href=\"grassdocs.css\" type=\"text/css\">\n");
 
     fprintf(stdout, "</head>\n");
 
     fprintf(stdout, "</head>\n");
 
-    fprintf(stdout, "<body bgcolor=\"white\">\n\n");
 
+    fprintf(stdout, "<body bgcolor=\"white\">\n");
 
+    fprintf(stdout, "<div id=\"container\">\n\n");
 
     fprintf(stdout,
 
     fprintf(stdout,
 
 	    "<a href=\"index.html\"><img src=\"grass_logo.png\" alt=\"GRASS logo\"></a>\n");
 
 	    "<a href=\"index.html\"><img src=\"grass_logo.png\" alt=\"GRASS logo\"></a>\n");
 
     fprintf(stdout, "<hr class=\"header\">\n\n");
 
     fprintf(stdout, "<hr class=\"header\">\n\n");

+ 8 - 2
man/build_html.py
Xem Tập Tin 

@@ -2,7 +2,7 @@
 
 # -*- coding: utf-8 -*-
 
 # -*- coding: utf-8 -*-
 
 
 
 # utilities for generating HTML indices
 
 # utilities for generating HTML indices
 
-# (c) 2003-2006, 2009-2013 by the GRASS Development Team, Markus Neteler, Glynn Clements, Luca Delucchi
 
+# (c) 2003-2014 by the GRASS Development Team, Markus Neteler, Glynn Clements, Luca Delucchi
 
 
 
 import sys
 
 import sys
 
 import os
 
 import os
 
@@ -49,7 +49,7 @@ header2_tmpl = string.Template(\
 
 r""" <link rel="stylesheet" href="grassdocs.css" type="text/css">
 
 r""" <link rel="stylesheet" href="grassdocs.css" type="text/css">
 
 </head>
 
 </head>
 
 <body style="width: ${body_width}">
 
 <body style="width: ${body_width}">
 
-
 
+<div id="container">
 
 <!-- this file is generated by man/build_html.py -->
 
 <!-- this file is generated by man/build_html.py -->
 
 
 
 <a href="index.html"><img src="grass_logo.png" alt="GRASS logo"></a>
 
 <a href="index.html"><img src="grass_logo.png" alt="GRASS logo"></a>
 
@@ -189,6 +189,8 @@ footer_tmpl = string.Template(\
 
 r"""<hr class="header">
 
 r"""<hr class="header">
 
 <p><a href="${index_url}">Help Index</a> | <a href="topics.html">Topics Index</a> | <a href="keywords.html">Keywords Index</a> | <a href="full_index.html">Full Index</a></p>
 
 <p><a href="${index_url}">Help Index</a> | <a href="topics.html">Topics Index</a> | <a href="keywords.html">Keywords Index</a> | <a href="full_index.html">Full Index</a></p>
 
 <p>&copy; 2003-${year} <a href="http://grass.osgeo.org">GRASS Development Team</a>, GRASS GIS ${grass_version} Reference Manual</p>
 
 <p>&copy; 2003-${year} <a href="http://grass.osgeo.org">GRASS Development Team</a>, GRASS GIS ${grass_version} Reference Manual</p>
 
+
 
+</div>
 
 </body>
 
 </body>
 
 </html>
 
 </html>
 
 """)
 
 """)
 
@@ -209,6 +211,7 @@ r"""<tr><td valign="top"><a href="${cmd}">${basename}</a></td> <td>${desc}</td><
 
 toc = \
 
 toc = \
 
 r"""
 
 r"""
 
 <div class="toc">
 
 <div class="toc">
 
+<h4 class="toc">Table of contents</h4>
 
 <ul class="toc">
 
 <ul class="toc">
 
 <li class="toc"><a class="toc" href="full_index.html#d">Display commands (d.*)</a></li>
 
 <li class="toc"><a class="toc" href="full_index.html#d">Display commands (d.*)</a></li>
 
 <li class="toc"><a class="toc" href="full_index.html#db">Database commands (db.*)</a></li>
 
 <li class="toc"><a class="toc" href="full_index.html#db">Database commands (db.*)</a></li>
 
@@ -271,6 +274,7 @@ r"""
 
 <link rel="stylesheet" href="grassdocs.css" type="text/css">
 
 <link rel="stylesheet" href="grassdocs.css" type="text/css">
 
 </head>
 
 </head>
 
 <body style="width: 99%">
 
 <body style="width: 99%">
 
+<div id="container">
 
 
 
 <a href="index.html"><img src="grass_logo.png" alt="GRASS logo"></a>
 
 <a href="index.html"><img src="grass_logo.png" alt="GRASS logo"></a>
 
 <hr class="header">
 
 <hr class="header">
 
@@ -284,6 +288,7 @@ r"""
 
 <link rel="stylesheet" href="grassdocs.css" type="text/css">
 
 <link rel="stylesheet" href="grassdocs.css" type="text/css">
 
 </head>
 
 </head>
 
 <body style="width: 99%">
 
 <body style="width: 99%">
 
+<div id="container">
 
 
 
 <a href="index.html"><img src="grass_logo.png" alt="GRASS logo"></a>
 
 <a href="index.html"><img src="grass_logo.png" alt="GRASS logo"></a>
 
 <hr class="header">
 
 <hr class="header">
 
@@ -296,6 +301,7 @@ r"""
 
 <link rel="stylesheet" href="grassdocs.css" type="text/css">
 
 <link rel="stylesheet" href="grassdocs.css" type="text/css">
 
 </head>
 
 </head>
 
 <body bgcolor="white">
 
 <body bgcolor="white">
 
+<div id="container">
 
 
 
 <a href="index.html"><img src="grass_logo.png" alt="GRASS logo"></a>
 
 <a href="index.html"><img src="grass_logo.png" alt="GRASS logo"></a>
 
 <hr class="header">
 
 <hr class="header">

+ 67 - 7
man/grassdocs.css
Xem Tập Tin 

@@ -1,4 +1,4 @@
 
-/* GRASS documentation site style sheet
 
+/* GRASS GIS documentation site style sheet
 
  *
 
  *
 
  * send improvements to GRASS Developers list
 
  * send improvements to GRASS Developers list
 
  * 
  * 
@@ -14,7 +14,24 @@ body{
 
     background: white;
 
     background: white;
 
     color: black;
 
     color: black;
 
     font-family: arial,sans-serif;
 
     font-family: arial,sans-serif;
 
-    width: 80%;
 
+}
 
+
 
+#container
 
+{
 
+    position: relative;
 
+    margin: 0 auto;
 
+    padding-left:  10px;
 
+    padding-right: 10px;
 
+    width: 700px;
 
+    background-color: white;
 
+    height:auto !important;
 
+    min-height: 100%;
 
+    border-style:solid;
 
+    border-bottom-width: 2px;
 
+    border-top-width: 2px;
 
+    border-left-width: 10px;
 
+    border-right-width: 10px;
 
+    border-color: #DDDDDD;
 
 }
 
 }
 
 
 
 hr.header {
 
 hr.header {
 
@@ -29,7 +46,8 @@ h1{
 
     color: rgb(25%, 60%, 25%);
 
     color: rgb(25%, 60%, 25%);
 
     font-family: arial,sans-serif;
 
     font-family: arial,sans-serif;
 
     font-weight: bold;
 
     font-weight: bold;
 
-    font-size: x-large;
 
+    font-size: xx-large;
 
+    width: 80%; /* avoid collision with toc */
 
 }
 
 }
 
 
 
 h2{
 
 h2{
 
@@ -37,7 +55,7 @@ h2{
 
     color: rgb(25%, 60%, 25%);
 
     color: rgb(25%, 60%, 25%);
 
     font-family: arial,sans-serif;
 
     font-family: arial,sans-serif;
 
     font-weight: bold;
 
     font-weight: bold;
 
-    font-size: large;
 
+    font-size: x-large;
 
 }
 
 }
 
 
 
 h3{
 
 h3{
 
@@ -56,6 +74,14 @@ h4{
 
     font-size: medium;
 
     font-size: medium;
 
 }
 
 }
 
 
 
+a {
 
+    color: rgb(25%, 60%, 25%);
 
+}
 
+
 
+a:visited {
 
+    color: rgb(25%, 60%, 25%);
 
+}
 
+
 
 div.code{
 
 div.code{
 
     width: 97%;
 
     width: 97%;
 
     color : black;
 
     color : black;
 
@@ -104,7 +130,7 @@ td {
 
 }
 
 }
 
 
 
 div.toc{
 
 div.toc{
 
-    background-color: transparent;
 
+    /* background-color: transparent; */
 
     position: fixed;
 
     position: fixed;
 
     border: solid 1px rgb(25%, 60%, 25%);
 
     border: solid 1px rgb(25%, 60%, 25%);
 
     top: 5px;
 
     top: 5px;
 
@@ -112,19 +138,53 @@ div.toc{
 
     width: 17%;
 
     width: 17%;
 
     font-size: small;
 
     font-size: small;
 
     border-radius: 10px;
 
     border-radius: 10px;
 
+    z-index: 1;
 
 }
 
 }
 
 
 
 li.toc {
 
 li.toc {
 
-   margin-left: -15px;
 
-   padding: 3px 3px; 3px; 3px;
 
+   margin-left: 0;
 
+   padding: 3px 3px 3px 3px;
 
+   padding-left: 0;
 
    color: rgb(25%, 60%, 25%);
 
    color: rgb(25%, 60%, 25%);
 
 }
 
 }
 
 
 
 ul.toc {
 
 ul.toc {
 
    margin-top: 3px;
 
    margin-top: 3px;
 
    margin-bottom: 3px;
 
    margin-bottom: 3px;
 
+   padding-left: 10%;
 
+   margin-left: 5%;
 
 }
 
 }
 
 
 
 a.toc {
 
 a.toc {
 
     text-decoration: none;
 
     text-decoration: none;
 
 }
 
 }
 
+
 
+a.toc:hover, a.toc:active {
 
+    text-decoration: underline;
 
+}
 
+
 
+h4.toc {
 
+    padding-top: 3px;
 
+    margin-top: 3px;
 
+    padding-bottom: 3px;
 
+    margin-bottom: 3px;
 
+    padding-left: 6px;
 
+}
 
+
 
+/* show and hide toc */
 
+
 
+div.toc:hover ul {
 
+  display: block;
 
+}
 
+
 
+div.toc ul {
 
+  display: none;
 
+}
 
+
 
+div.toc:hover {
 
+  background-color: white;
 
+}
 
+
 
+div.toc {
 
+  background-color: rgba(255, 255, 255, 0.7);
 
+}

+ 5 - 0
tools/mkhtml.py
Xem Tập Tin 

@@ -36,6 +36,8 @@ header_base = """<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
 <link rel="stylesheet" href="grassdocs.css" type="text/css">
 
 <link rel="stylesheet" href="grassdocs.css" type="text/css">
 
 </head>
 
 </head>
 
 <body bgcolor="white">
 
 <body bgcolor="white">
 
+<div id="container">
 
+
 
 <a href="index.html"><img src="grass_logo.png" alt="GRASS logo"></a>
 
 <a href="index.html"><img src="grass_logo.png" alt="GRASS logo"></a>
 
 <hr class="header">
 
 <hr class="header">
 
 """
 
 """
 
@@ -51,6 +53,7 @@ footer_index = string.Template(\
 
 """<hr class="header">
 
 """<hr class="header">
 
 <p><a href="index.html">Main index</a> | <a href="${INDEXNAME}.html">${INDEXNAMECAP} index</a> | <a href="topics.html">Topics index</a> | <a href="keywords.html">Keywords Index</a> | <a href="full_index.html">Full index</a></p>
 
 <p><a href="index.html">Main index</a> | <a href="${INDEXNAME}.html">${INDEXNAMECAP} index</a> | <a href="topics.html">Topics index</a> | <a href="keywords.html">Keywords Index</a> | <a href="full_index.html">Full index</a></p>
 
 <p>&copy; 2003-${YEAR} <a href="http://grass.osgeo.org">GRASS Development Team</a>, GRASS GIS ${GRASS_VERSION} Reference Manual</p>
 
 <p>&copy; 2003-${YEAR} <a href="http://grass.osgeo.org">GRASS Development Team</a>, GRASS GIS ${GRASS_VERSION} Reference Manual</p>
 
+</div>
 
 </body>
 
 </body>
 
 </html>
 
 </html>
 
 """)
 
 """)
 
@@ -59,6 +62,7 @@ footer_noindex = string.Template(\
 
 """<hr class="header">
 
 """<hr class="header">
 
 <p><a href="index.html">Main index</a> | <a href="topics.html">Topics index</a> | <a href="keywords.html">Keywords Index</a> | <a href="full_index.html">Full index</a></p>
 
 <p><a href="index.html">Main index</a> | <a href="topics.html">Topics index</a> | <a href="keywords.html">Keywords Index</a> | <a href="full_index.html">Full index</a></p>
 
 <p>&copy; 2003-${YEAR} <a href="http://grass.osgeo.org">GRASS Development Team</a>, GRASS GIS ${GRASS_VERSION} Reference Manual</p>
 
 <p>&copy; 2003-${YEAR} <a href="http://grass.osgeo.org">GRASS Development Team</a>, GRASS GIS ${GRASS_VERSION} Reference Manual</p>
 
+</div>
 
 </body>
 
 </body>
 
 </html>
 
 </html>
 
 """)
 
 """)
 
@@ -133,6 +137,7 @@ def write_toc(data):
 
     
     
     fd = sys.stdout
 
     fd = sys.stdout
 
     fd.write('<div class="toc">\n')
 
     fd.write('<div class="toc">\n')
 
+    fd.write('<h4 class="toc">Table of contents</h4>\n')
 
     fd.write('<ul class="toc">\n')
 
     fd.write('<ul class="toc">\n')
 
     first = True
 
     first = True
 
     has_h2 = False
 
     has_h2 = False