[QGIS Commit] r10631 -
docs/trunk/english_us/coding-compilation_guide
svn_qgis at osgeo.org
svn_qgis at osgeo.org
Thu Apr 23 04:20:52 EDT 2009
Author: dassau
Date: 2009-04-23 04:20:52 -0400 (Thu, 23 Apr 2009)
New Revision: 10631
Modified:
docs/trunk/english_us/coding-compilation_guide/coding-compilation_guide.tex
docs/trunk/english_us/coding-compilation_guide/conventions.tex
docs/trunk/english_us/coding-compilation_guide/preamble.tex
docs/trunk/english_us/coding-compilation_guide/qgis_style.sty
docs/trunk/english_us/coding-compilation_guide/title.tex
Log:
cleaned up the structure of the new coding and compilation guide
updated the title and preamble sections with new authors
Modified: docs/trunk/english_us/coding-compilation_guide/coding-compilation_guide.tex
===================================================================
--- docs/trunk/english_us/coding-compilation_guide/coding-compilation_guide.tex 2009-04-23 06:50:47 UTC (rev 10630)
+++ docs/trunk/english_us/coding-compilation_guide/coding-compilation_guide.tex 2009-04-23 08:20:52 UTC (rev 10631)
@@ -4,61 +4,25 @@
% \documentclass[a4paper,dvips,onecolumn,11pt,titlepage]{scrreprt}
\usepackage{qgis_style}
-
\begin{document}
\include{title}
\include{preamble}
\include{toc}
-\include{forward}
-\include{conventions}
\include{introduction}
-\include{getting_started}
-\include{features_at_a_glance}
-\include{working_with_vector}
-\include{working_with_raster}
-\include{working_with_ogc}
-\include{working_with_projections}
-\include{grass_integration}
-\include{print_composer}
-%first the general intro to plugins
-%then each individual plugin can have a section
-%in the plugins chapter
-\include{plugins}
-\include{core_plugins}
-\include{plugins_coordinate_capture}
-\include{plugins_decorations}
-\include{plugins_delimited_text}
-\include{plugins_dxf2shape_converter}
-\include{plugins_georeferencer}
-\include{plugins_quick_print}
-\include{plugins_gps}
-\include{plugins_graticule_creator}
-\include{plugins_interpolation}
-\include{plugins_mapserver_export}
-\include{plugins_ogr_converter}
-\include{external_plugins}
-%\include{plugins_ftools}
-%\include{plugins_table_manager}
-%\include{plugins_raster_algebra}
\include{plugins_writing_in_cpp}
-\include{plugins_writing_in_python}
-%end of plugin docs
\include{creating_cpp_applications}
+\include{plugins_writing_in_python}
\include{creating_pyqgis_applications}
\include{help_and_support}
-\appendix
-\include{appendices/supported_data_formats}
-\include{appendices/grass_toolbox_modules}
-%install guide is a special case because we are extracting it
-%out of the INSTALL.t2t document of in the QGIS sources
+%install and coding guide is a special case because we are extracting it
+%out of the INSTALL.t2t and CODING.t2t document of in the QGIS sources
%when we tag a new document release
\include{install}
\include{coding}
\include{appendices/gpl}
\include{appendices/qgis_qt_gpl_exception}
\include{literature}
-\include{index}
\begin{htmlonly}
\input{qgis_style.tex}
Modified: docs/trunk/english_us/coding-compilation_guide/conventions.tex
===================================================================
--- docs/trunk/english_us/coding-compilation_guide/conventions.tex 2009-04-23 06:50:47 UTC (rev 10630)
+++ docs/trunk/english_us/coding-compilation_guide/conventions.tex 2009-04-23 08:20:52 UTC (rev 10631)
@@ -1,14 +1,15 @@
% vim: set textwidth=78 autoindent:
-
-\section{Conventions}\label{label_conventions}
-\pagenumbering{arabic}
-\setcounter{page}{1}
-
-
%%%%%%%%%%%%%%%%8%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% This is a collection of macros to maintain a uniform style throughout
% the user guide.
+% Many of the styles are intended to mimic the appearance of the GUI.
+% In general, the objective is to use the non-hover appearance, so a user
+% can visually scan the GUI to find something that looks like the instruction
+% in the user guide.
+% Text styles related to coding are used to indicate different kinds of
+% entities, such as classes, methods, etc, and therefore don't correspond to
+% any actual appearance.
%
% TEXT STYLES
% These styles change the text appearance but don't add any shadow boxes
@@ -20,63 +21,49 @@
% Note: for user input into a labelled text field in the GUI, see \inputtext
% usage: \usertext{qgis ---help}
\newcommand{\usertext}[1]{\texttt{#1}}
-
+%
% filename
% usage: \filename{lakes.shp}
\newcommand{\filename}[1]{\texttt{#1}}
-
-% dropmenuopttwo: for dropdown menu items with icons
-% usage: \mainmenuopt{Layer} >
-% \dropmenuopttwo{mActionAddRasterLayer}{Add a Raster Layer}
-\newcommand{\dropmenuopttwo}[2]{%
-\raisebox{-6pt}{%
-{%
-\setlength{\fboxsep}{0pt}%
-\shadowbox{\setlength{\fboxsep}{2pt}%
-\fcolorbox[rgb]{.95,.95,0.8}[rgb]{.95,.95,0.8}%
-{\includegraphics[width=3mm]{#1} \guilabel{#2}}}%
-}}}
-
-% button: for any button that only has text, no icon
-% usage: \button{Save as Default}
-\newcommand{\button}[1]{%
-\raisebox{-6pt}{%
-\shadowbox{\guilabel{#1}}
-}}
-
+%
% server
% usage: \server{myhost.de}
\newcommand{\server}[1]{\textit{#1}}
-
% keystroke
% style for user input by individual keystrokes
% usage: \keystroke{p}, \keystroke{Ctrl+B}
\newcommand{\keystroke}[1]{\cornersize{.6}\ovalbox{\textsf{#1}}}
-
+%
% guilabel
% generic style for text that appears in the GUI
% usage
\newcommand{\guilabel}[1]{\textsf{#1}}
-
+%
+% guiheading
+% style for section heading that appear in dialog boxes
+% such as Vector Layer Properties > metadata
+% usage
+\newcommand{\guiheading}[1]{\textsf{#1}}
+%
% dialog
% usage: \dialog{Layer Properties}
\newcommand{\dialog}[1]{
\fcolorbox{gray}[rgb]{.95,.95,0.8}{%
\textbf{\textcolor{black}{#1}}}}
-
+%
% Here are some styles for use only when discussing Python coding
% classname
% usage: \classname{NewLayer}
\newcommand{\classname}[1]{\textsf{\textbf{#1}}}
-
+%
% object
% usage
\newcommand{\object}[1]{\textsf{\textit{#1}}}
-
+%
% method
% usage: \method{classFactory}
\newcommand{\method}[1]{\textsf{\textit{#1}}}
-
+%
% fieldname: part of the set intend to be used to describe Python coding.
% So "field" in this case refers to data members of a class or object, not
% a "field" from a table or database.
@@ -91,37 +78,358 @@
% label, the other for the selected text.
%\newcommand{\fieldname}[1]{\textsl{#1}}%
+%
% ??? these styles are from Gary: use only in
%\newcommand{\sqltable}[1]{\textsf{\textbf{#1}}}
+
% CLICKABLE STYLES
% These styles add a shadow box to indicate the user can click on something
% this command sets the shadow size for the entire document
\setlength{\shadowsize}{2pt}%
-% Icons for different operation systems
+% button: for any button that only has text, no icon
+% usage: \button{Save as Default}
+\newcommand{\button}[1]{%
+\raisebox{-6pt}{%
+\shadowbox{\guilabel{#1}}
+}}
+% mainmenuopt: for the top level menus such as File
+% usage: \mainmenuopt{Layer}
+\newcommand{\mainmenuopt}[1]{%
+\raisebox{-6pt}{%
+\setlength{\fboxsep}{0pt}%
+\shadowbox{\setlength{\fboxsep}{2pt}%
+\fcolorbox[gray]{0.9}[gray]{0.9}%
+{\guilabel{#1}}%
+}}}
+% dropmenuopt: for dropdown menu items with no icon
+% usage: \mainmenuopt{View} > \dropmenuopt{Toolbar Visibility}
+\newcommand{\dropmenuopt}[1]{%
+\raisebox{-6pt}{{%
+\setlength{\fboxsep}{0pt}%
+\shadowbox{\setlength{\fboxsep}{2pt}%
+\fcolorbox[rgb]{.95,.95,0.8}[rgb]{.95,.95,0.8}%
+{ \guilabel{#1}}}%
+}}}
+% dropmenucheck: for dropdown menu checkboxes
+% usage: \mainmenuopt{View} > \dropmenucheck{Legend}
+\newcommand{\dropmenucheck}[1]{%
+\raisebox{-6pt}{{%
+\setlength{\fboxsep}{0pt}%
+\shadowbox{\setlength{\fboxsep}{2pt}%
+\fcolorbox[rgb]{.95,.95,0.8}[rgb]{.95,.95,0.8}%
+{ $\boxtimes$ \guilabel{#1}}}%
+}}}
+% dropmenuopttwo: for dropdown menu items with icons
+% usage: \mainmenuopt{Layer} >
+% \dropmenuopttwo{mActionAddRasterLayer}{Add a Raster Layer}
+\newcommand{\dropmenuopttwo}[2]{%
+\raisebox{-6pt}{%
+{%
+\setlength{\fboxsep}{0pt}%
+\shadowbox{\setlength{\fboxsep}{2pt}%
+\fcolorbox[rgb]{.95,.95,0.8}[rgb]{.95,.95,0.8}%
+{\includegraphics[width=3mm]{#1} \guilabel{#2}}}%
+}}}
+% tooltip: for the tooltip that appears when hovering on a tool button
+% usage
+\newcommand{\tooltip}[1]{%
+\raisebox{-2pt}{%
+\fcolorbox{black}[rgb]{1,1,0.8}{\guilabel{#1}}%
+}}
+% toolbtntwo: for toolbar items
+%usage: \toolbtntwo{mActionAddRasterLayer}{Add a Raster Layer}
+%
+\newcommand{\toolbtntwo}[2]{%
+\raisebox{-6pt}{%
+\shadowbox{\includegraphics[width=7mm]{#1}}} %
+\tooltip{#2}%
+}
+%\toolbox
+%Used only for menu items (modules) in the GRASS toolbox.
+%These icons may use 1 or more
+%images, and so require different numbers of arguments.
+% \toolboxtwo takes two arguments: one image name and a text label, and so on.
+%The images have names like nviz.1.eps.
+%This naming convention, or something like it, is required because some modules
+%require a set of images to represent them, indicating for example, the
+%starting format and the ending format of a conversion module. When
+%referring to these images in the latex source, it is necessary to
+%include the .eps extension, otherwise the \includegraphics macro looks
+%for nviz.1 and can't find it.
+% toolboxtwo
+% usage: \toolboxtwo{nviz.1.eps}{nviz - Open 3D-View in NVIZ}
+\newcommand{\toolboxtwo}[2]{%
+\raisebox{-6pt}{%
+\shadowbox{%
+\raisebox{-2pt}{\includegraphics[width=5mm]{#1}}%
+\guilabel{ #2}%
+}}}
+% toolboxthree
+% usage: two icons are used to describe a transformation
+%\toolboxthree{r.in.gdal.1.eps}{r.in.gdal.2.eps}%
+%{r.in.gdal - Import GDAL supported raster file
+%into a binary raster map layer}%
+\newcommand{\toolboxthree}[3]{%
+\raisebox{-6pt}{%
+\shadowbox{%
+\includegraphics[width=5mm]{#1}%
+->%
+\includegraphics[width=5mm]{#2}%
+ \guilabel{#3}%
+}}}
+% toolboxfour
+% usage: similar to toolboxthree, but two kinds of inputs
+% are combined to create a third
+\newcommand{\toolboxfour}[4]{%
+\raisebox{-6pt}{%
+\shadowbox{%
+\includegraphics[width=5mm]{#1}%
++%
+\includegraphics[width=5mm]{#2}%
+->%
+\includegraphics[width=5mm]{#3}%
+ \guilabel{#4}%
+}}}
+
+% tab: for tabs in dialog boxes
+% usage: \tab{General}
+\newcommand{\tab}[1]{%
+\raisebox{-6pt}{%
+\shadowbox{\guilabel{#1}}
+}}
+% checkbox: for checkboxes in dialog boxes
+% usage: \checkbox{Render}
+\newcommand{\checkbox}[1]{%
+\raisebox{2pt}{%
+\fbox{%
+\raisebox{-4pt}{%
+\shadowbox{x}} %
+\guilabel{#1}}%
+}}
+% radiobuttonoff: to indicate a radiobutton in the off state
+% usage: \radiobuttonon{Postgis SRID} \radiobuttonoff{EPSG ID}
+\newcommand{\radiobuttonoff}[1]{%
+\raisebox{-4pt}{%
+\setlength{\fboxsep}{1pt}%
+\shadowbox{%
+$\bigcirc$%$
+}} %
+\guilabel{#1}%
+}
+% radiobuttonon: to indicate a radiobutton in the on state
+% usage: \radiobuttonon{Postgis SRID} \radiobuttonoff{EPSG ID}
+\newcommand{\radiobuttonon}[1]{%
+$\odot$ %$
+\guilabel{#1}%
+}
+% selectnumber: a selection field with numerical values
+% usage: \selectnumber{Hue}{60}
+\newcommand{\selectnumber}[2]{%
+\fbox{%
+{#1} \fbox{{#2} %
+\raisebox{-6pt}{%
+\setlength{\fboxsep}{1pt}%
+\shadowbox{%
+${\blacktriangle}\atop{\blacktriangledown}$%$
+}}}}}
+%
+% selectstring: a selection field with string values
+% usage: \selectstring{Outline style}{---Solid Line}
+\newcommand{\selectstring}[2]{%
+\fbox{%
+\guilabel{#1} \fbox{\guilabel{#2} %
+\raisebox{-2pt}{%
+\setlength{\fboxsep}{1pt}%
+\shadowbox{%
+$\blacktriangledown$%$
+}}}}}
+%
+% browsebutton: a button with 3 dots, used to browse for files
+% usage: \browsebutton
+\newcommand{\browsebutton}{%
+\raisebox{-6pt}{%
+\shadowbox{\rule[-1mm]{0mm}{4mm}{$\ldots$}}
+}}
+%
+% selectcolor: a selection field for colors
+% usage: \selectcolor{Outline color}{yellow}
+\newcommand{\selectcolor}[2]{%
+\fbox{\guilabel{#1} %
+\raisebox{-6pt}{%
+\setlength{\fboxsep}{0pt}%
+\shadowbox{\setlength{\fboxsep}{2pt}%
+\fcolorbox{#2}{#2}{\rule{0mm}{5mm}\rule{35mm}{0mm}%
+}}}}}
+%
+% slider: these appear in several dialog boxes
+% usage: \slider{Transparency}{0}{20mm}
+\newcommand{\slider}[3]{%
+\fbox{%
+\guilabel{#1} \guilabel{#2}\% %
+\raisebox{-2pt}{%
+\setlength{\fboxsep}{1pt}%
+\shadowbox{%
+$\triangledown$%
+}}%$
+\negthinspace\rule[1mm]{20mm}{1mm}
+}}
+%
+% input text: a labelled field in a dialog box where the user types in text
+% usage: \inputtext{Display Name}{lakes.shp}
+\newcommand{\inputtext}[2]{%
+\fbox{%
+\guilabel{#1} %
+\raisebox{-6pt}{%
+\shadowbox{\usertext{#2}}%
+}}}
+%
+% clicklistitem: clickable list item in a dialog box
+% the actual text in the list item will depend on the application
+% usage: \clicklistitem{Canadian Land}
+\newcommand{\clicklistitem}[1]{%
+\raisebox{-6pt}{%
+\shadowbox{\guilabel{#1}}
+}}
+
+% NON-CLICKABLE IMAGE STYLES
+% These styles insert images to indicate platform-specific documentation
+% usage:
+% inline usage: for GUI sequences and short text
+% Click \{\nix{}\win{File} \osx{QGIS}\} > Quit to close QGIS.
+% itemized usage: for moderate amounts of text
+%\begin{itemize}
+%\item \nix{do this;}
+%\item \win{do that;}
+%\item \osx{do something else.}
+%\end{itemize}
+% paragrahs usage: for larger amounts of text
+%
+%\nix{}Do this and this and this. Then do this
+%and this and this
+%and this and this
+%and this and this
+%and this and this.
+%
+%Note: on OSX the following commands differ from *NIX and Windows
+%- options dialog is called preferences and is found under
+% QGIS->Preferences and the shortcut will always be Command , (command
+% comma)
+%- What is usually the Help->about dialog will always be QGIS->About qgis
+%- File->Quit will always be QGIS->Quit qgis and the keyboard
+% shortcut should always be Command Q
+%- Colour, font and file dialogs will have differences between platforms
+%- if other differences are discovered, please add here
\newcommand{\nix}[1]{\includegraphics[height=5mm]{nix.eps} #1}
\newcommand{\win}[1]{\includegraphics[height=5mm]{win.eps} #1}
\newcommand{\osx}[1]{\includegraphics[height=5mm]{osx.eps} #1}
-
+%
% add operation system icons to figure \caption
% usage: \caption{Text \wincaption}
\newcommand{\nixcaption}{\protect\includegraphics[height=4mm]{nix.eps}}
\newcommand{\wincaption}{\protect\includegraphics[height=4mm]{win.eps}}
\newcommand{\osxcaption}{\protect\includegraphics[height=4mm]{osx.eps}}
+
% OTHER STYLES
% some styles for the Qt GUI- these are placeholders at present
\newcommand{\qtmainmenuopt}[1]{\textsf{#1}}
\newcommand{\qtdropmenuopt}[1]{\textsf{#1}}
\newcommand{\qtdialog}[1]{\textsf{#1}}
+
+% These styles were used in an earlier version and should not be used anymore
+%\toolbox: use \toolboxtwo instead
+%\newcommand{\toolbox}[2]{%
+%\toolboxtwo{#1}{#2}%
+%}
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% here the section starts %%%%%%%%%%%%%%%%%%%%%
+%
+\subsection{Conventions}\label{label_conventions}
This section describes a collection of uniform styles throughout the manual.
The conventions used in this manual are as follows:
+\minisec{GUI Conventions}
+
+The GUI convention styles are intended to mimic the appearance of the GUI. In
+general, the objective is to use the non-hover appearance, so a user can
+visually scan the GUI to find something that looks like the instruction
+in the manual.
+
+\begin{itemize}
+%
+%Use \mainmenuopt for main menu items that have no icon only text
+%Main Menu includes: File, View, Layer, Settings, Plugins, Help
+\item Menu Options: \mainmenuopt{Layer} > %
+%
+%Use \dropmenuopttwo for a drop-down menu item with an icon
+%Use \dropmenuoptone for a drop-down menu item with no icon
+\dropmenuopttwo{mActionAddRasterLayer}{Add a Raster Layer}
+
+or
+
+\mainmenuopt{Settings} > %
+\dropmenuopt{Toolbars} > \dropmenucheck{Digitizing}
+%
+%Use \toolbtntwo for the toolbar items, including those that open dialogs
+%These have an icon, and display a tooltip on hover
+%Its really important to get the icon in there because that's what a user
+%has to search for. The tooltip adds confirmation
+\item Tool: \toolbtntwo{mActionAddRasterLayer}{Add a Raster Layer}
+%
+%Use \button for a clickable button which has no icon, just text
+%Save As Default is a button that appears in the Layer Properties dialog.
+\item Button: \button{Save as Default}
+%
+%
+%Use \dialog for the title of a dialog box
+%such as the Layer Properties dialog.
+%Please use the exact title as it appears in the GUI.
+\item Dialog Box Title: \dialog{Layer Properties}
+%
+%Use \tab for clickable tabs which have no icons, just text
+%General is a tab that appears in the Layer Properties dialog.
+%At the moment, it looks just like \button, but that may change.
+\item Tab: \tab{General}
+%
+%Use \toolboxtwo, \toolboxthree or \toolboxfour
+% for GRASS toolbox (not toolbar) items
+%These are what you see in the menu after you click Open GRASS Tools
+%The one you need depends on how many icons are required
+%The number part of the name is the total number of arguments (N)
+%The number of icons is (N-1)
+\item Toolbox Item: \toolboxtwo{nviz.1.eps}{nviz - Open 3D-View in NVIZ}
+%
+%Use \checkbox for a checkbox item in a dialog popup
+\item Checkbox: \checkbox{Render}
+%
+%Use \radiobuttonoff for a radio button item in a dialog popup
+\item Radio Button: \radiobuttonon{Postgis SRID} \radiobuttonoff{EPSG ID}
+%
+% Use \selectnumber for a selection box with up and down arrows
+% and a numerical value
+\item Select a Number: \selectnumber{Hue}{60}
+%
+% Use \selectstring for a selection box with down arrows
+% and a string value
+\item Select a String: \selectstring{Outline style}{---Solid Line}
+%
+%
+% Use \browsebutton for a button that opens a file browser popup
+\item Browse for a File: \browsebutton
+%
+% Use \selectcolor for a button which opens a color selector popup
+\item Select a Color: \selectcolor{Outline color}{yellow}
+%
+\item Slider: \slider{Transparency}{0}{20mm}
+%
+% Use \inputtext for a labelled field for user input of text
+\item Input Text: \inputtext{Display Name}{lakes.shp}
+\end{itemize}
+A shadow indicates a clickable GUI component.
+
\minisec{Text or Keyboard Conventions}
The manual also includes styles related to text, keyboard commands and coding
@@ -134,7 +442,8 @@
\item Hyperlinks: \url{http://qgis.org}
%
\item Single Keystroke: press \keystroke{p}
-\item Keystroke Combinations: press \keystroke{Ctrl+B}, meaning press and hold the Ctrl key and then press the B key.
+\item Keystroke Combinations: press \keystroke{Ctrl+B}, meaning press and
+hold the Ctrl key and then press the B key.
\item Name of a File: \filename{lakes.shp}
%\item Name of a Field: \fieldname{NAMES}
\item Name of a Class: \classname{NewLayer}
@@ -155,8 +464,12 @@
\minisec{Platform-specific instructions}
-This indicates that on Linux, Unix and Windows platforms you need to follow
-different instructions. Larger amounts of text may be formatted as a list:
+GUI sequences and small amounts of text can be formatted inline: Click
+\{\nix{}\win{File} \osx{QGIS}\} > Quit to close QGIS. This indicates that on
+Linux, Unix and Windows platforms, click the File menu option first, then
+Quit from the dropdown menu, while on Macintosh OSX platforms, click the QGIS
+menu option first, then Quit from the dropdown menu. Larger amounts of text
+may be formatted as a list:
\begin{itemize}
\item \nix{do this;}
Modified: docs/trunk/english_us/coding-compilation_guide/preamble.tex
===================================================================
--- docs/trunk/english_us/coding-compilation_guide/preamble.tex 2009-04-23 06:50:47 UTC (rev 10630)
+++ docs/trunk/english_us/coding-compilation_guide/preamble.tex 2009-04-23 08:20:52 UTC (rev 10631)
@@ -9,11 +9,11 @@
% when the revision of a section has been finalized,
% comment out the following line:
-\updatedisclaimer
+%\updatedisclaimer
\vspace{1cm}
-This document is the original coding and compilation guide of the described
+This document is the original Coding and Compilation Guide of the described
software Quantum GIS. The software and hardware described in this
document are in most cases registered trademarks and are therefore subject
to the legal requirements. Quantum GIS is subject to the GNU General Public
@@ -29,13 +29,15 @@
their consequences. Your are always welcome to indicate possible mistakes.
This document has been typeset with \LaTeX. It is available as \LaTeX~source
-code via \href{http://wiki.qgis.org/qgiswiki/DocumentationWritersCorner}{subversion}
+code via \href{http://www.qgis.org/wiki/index.php/Manual_Writing}{subversion}
and online as PDF document via \url{http://qgis.osgeo.org/documentation/manuals.html}.
Translated versions of this document can be downloaded via the documentation
area of the QGIS project as well. For more information about contributing to
this document and about translating it, please visit:
-\url{http://wiki.qgis.org/qgiswiki/DocumentationWritersCorner}
+\url{http://www.qgis.org/wiki/index.php/Community_Ressources}
+\vspace{0.5cm}
+
\textbf{Links in this Document}
This document contains internal and external links. Clicking on an
@@ -49,18 +51,20 @@
\textbf{Coding Compilation Guide Authors and Editors:}
\begin{tabular}{p{5cm} p{5cm} p{5cm}}
-Tim Sutton & Otto Dassau & Godofredo Contreras \\
-Tara Athan & Gary E. Sherman & Werner Macho \\
+Tim Sutton & Marco Hugentobler & Gary E. Sherman \\
+Tara Athan & Godofredo Contreras & Werner Macho \\
+Carson Farmer & Otto Dassau & J\"urgen E. Fischer \\
+Davis Wills & Magnus Homann & Martin Dobias \\
\end{tabular}
-\vspace{2cm}
-
With thanks to Tisham Dhar for preparing the initial msys (MS Windows)
environment documentation, to Tom Elwertowski and William Kyngesburye for
help in the MAC OSX Installation Section and to Carlos D\'{a}vila. If we have
neglected to mention any contributors, please accept our apologies for this
oversight.
+\vspace{0.5cm}
+
\textbf{Copyright \copyright~2004 - 2009 Quantum GIS Development Team} \\
\textbf{Internet:} \url{http://qgis.osgeo.org}
\end{flushleft}
Modified: docs/trunk/english_us/coding-compilation_guide/qgis_style.sty
===================================================================
--- docs/trunk/english_us/coding-compilation_guide/qgis_style.sty 2009-04-23 06:50:47 UTC (rev 10630)
+++ docs/trunk/english_us/coding-compilation_guide/qgis_style.sty 2009-04-23 08:20:52 UTC (rev 10631)
@@ -209,3 +209,67 @@
\renewcommand{\@pnumwidth}{1.75em}
\renewcommand{\@tocrmarg}{2em}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% Here are some styles for use only when discussing Python coding
+% classname
+% usage: \classname{NewLayer}
+\newcommand{\classname}[1]{\textsf{\textbf{#1}}}
+%
+% object
+% usage
+\newcommand{\object}[1]{\textsf{\textit{#1}}}
+%
+% method
+% usage: \method{classFactory}
+\newcommand{\method}[1]{\textsf{\textit{#1}}}
+\newcommand{\usertext}[1]{\texttt{#1}}
+%
+% filename
+% usage: \filename{lakes.shp}
+\newcommand{\filename}[1]{\texttt{#1}}
+%
+% server
+% usage: \server{myhost.de}
+\newcommand{\server}[1]{\textit{#1}}
+% keystroke
+% style for user input by individual keystrokes
+% usage: \keystroke{p}, \keystroke{Ctrl+B}
+\newcommand{\keystroke}[1]{\cornersize{.6}\ovalbox{\textsf{#1}}}
+%
+% add operation system figure in text
+\newcommand{\nix}[1]{\includegraphics[height=5mm]{nix.eps} #1}
+\newcommand{\win}[1]{\includegraphics[height=5mm]{win.eps} #1}
+\newcommand{\osx}[1]{\includegraphics[height=5mm]{osx.eps} #1}
+%
+% add operation system icons to figure \caption
+% usage: \caption{Text \wincaption}
+\newcommand{\nixcaption}{\protect\includegraphics[height=4mm]{nix.eps}}
+\newcommand{\wincaption}{\protect\includegraphics[height=4mm]{win.eps}}
+\newcommand{\osxcaption}{\protect\includegraphics[height=4mm]{osx.eps}}
+% OTHER STYLES
+% some styles for the Qt GUI- these are placeholders at present
+\newcommand{\qtmainmenuopt}[1]{\textsf{#1}}
+\newcommand{\qtdropmenuopt}[1]{\textsf{#1}}
+\newcommand{\qtdialog}[1]{\textsf{#1}}
+% button: for any button that only has text, no icon
+% usage: \button{Save as Default}
+\newcommand{\button}[1]{%
+\raisebox{-6pt}{%
+\shadowbox{\guilabel{#1}}
+}}
+% dropmenuopttwo: for dropdown menu items with icons
+% usage: \mainmenuopt{Layer} >
+% \dropmenuopttwo{mActionAddRasterLayer}{Add a Raster Layer}
+\newcommand{\dropmenuopttwo}[2]{%
+\raisebox{-6pt}{%
+{%
+\setlength{\fboxsep}{0pt}%
+\shadowbox{\setlength{\fboxsep}{2pt}%
+\fcolorbox[rgb]{.95,.95,0.8}[rgb]{.95,.95,0.8}%
+{\includegraphics[width=3mm]{#1} \guilabel{#2}}}%
+}}}
+% guilabel
+% generic style for text that appears in the GUI
+% usage
+\newcommand{\guilabel}[1]{\textsf{#1}}
Modified: docs/trunk/english_us/coding-compilation_guide/title.tex
===================================================================
--- docs/trunk/english_us/coding-compilation_guide/title.tex 2009-04-23 06:50:47 UTC (rev 10630)
+++ docs/trunk/english_us/coding-compilation_guide/title.tex 2009-04-23 08:20:52 UTC (rev 10631)
@@ -15,7 +15,7 @@
\Large{Coding and Compilation Guide} \\
\vspace{0.5cm}
%\includegraphics[clip=true, scale=0.4]{splash}
-\Large{Version ~\CURRENT \textsl{'Kore'}}
+\Large{Version ~\CURRENT \textsl{'Pan'}}
\end{center}
\end{titlepage}
More information about the QGIS-commit
mailing list