[gnome-devel-docs] add a page for primary windows
- From: Allan Day <allanday src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gnome-devel-docs] add a page for primary windows
- Date: Tue, 19 Aug 2014 18:08:54 +0000 (UTC)
commit 647b4fdccd126a5a1a3d0f8604977c012a3375b0
Author: Allan Day <allanpday gmail com>
Date: Tue Aug 19 19:08:39 2014 +0100
add a page for primary windows
hig3/C/figures/patterns/primary-windows.svg | 245 +++++++++++++++++++++++++++
hig3/C/primary-windows.page | 70 ++++++++
2 files changed, 315 insertions(+), 0 deletions(-)
---
diff --git a/hig3/C/figures/patterns/primary-windows.svg b/hig3/C/figures/patterns/primary-windows.svg
new file mode 100644
index 0000000..445c30e
--- /dev/null
+++ b/hig3/C/figures/patterns/primary-windows.svg
@@ -0,0 +1,245 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+ xmlns:dc="http://purl.org/dc/elements/1.1/";
+ xmlns:cc="http://creativecommons.org/ns#";
+ xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#";
+ xmlns:svg="http://www.w3.org/2000/svg";
+ xmlns="http://www.w3.org/2000/svg";
+ xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd";
+ xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape";
+ width="940"
+ height="540"
+ id="svg6276"
+ version="1.1"
+ inkscape:version="0.48.4 r9939"
+ sodipodi:docname="action-bar.svg">
+ <defs
+ id="defs6278">
+ <mask
+ maskUnits="userSpaceOnUse"
+ id="mask20350">
+ <rect
+
style="fill:#ffffff;fill-opacity:1;stroke:#ffffff;stroke-width:2;stroke-linecap:square;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none"
+ id="rect20352"
+ width="153"
+ height="22"
+ x="-1864"
+ y="1028.3622" />
+ </mask>
+ </defs>
+ <sodipodi:namedview
+ id="base"
+ pagecolor="#ffffff"
+ bordercolor="#666666"
+ borderopacity="1.0"
+ inkscape:pageopacity="0.0"
+ inkscape:pageshadow="2"
+ inkscape:zoom="0.94335938"
+ inkscape:cx="489.84245"
+ inkscape:cy="157.55035"
+ inkscape:document-units="px"
+ inkscape:current-layer="layer1"
+ showgrid="false"
+ inkscape:showpageshadow="false"
+ inkscape:window-width="1920"
+ inkscape:window-height="1133"
+ inkscape:window-x="0"
+ inkscape:window-y="27"
+ inkscape:window-maximized="1">
+ <inkscape:grid
+ type="xygrid"
+ id="grid6749"
+ empspacing="5"
+ visible="true"
+ enabled="true"
+ snapvisiblegridlinesonly="true" />
+ </sodipodi:namedview>
+ <metadata
+ id="metadata6281">
+ <rdf:RDF>
+ <cc:Work
+ rdf:about="">
+ <dc:format>image/svg+xml</dc:format>
+ <dc:type
+ rdf:resource="http://purl.org/dc/dcmitype/StillImage"; />
+ <dc:title></dc:title>
+ </cc:Work>
+ </rdf:RDF>
+ </metadata>
+ <g
+ inkscape:label="Layer 1"
+ inkscape:groupmode="layer"
+ id="layer1"
+ transform="translate(0,-512.36218)">
+ <g
+ id="g3101"
+ transform="translate(0,2.9999974)">
+ <g
+ transform="translate(-40,-30)"
+ id="g3058">
+ <rect
+ inkscape:export-ydpi="90"
+ inkscape:export-xdpi="90"
+ inkscape:export-filename="/home/aday/checkout/gnome-devel-docs/hig3/C/figures/action-bars.png"
+ ry="9"
+ rx="9"
+ y="568.86218"
+ x="127.5"
+ height="106"
+ width="685"
+ id="rect8907"
+ style="fill:#e5e6e5;fill-opacity:1;stroke:#a7aba7;stroke-width:0.99999994;stroke-opacity:1" />
+ <rect
+ inkscape:export-ydpi="90"
+ inkscape:export-xdpi="90"
+ inkscape:export-filename="/home/aday/checkout/gnome-devel-docs/hig3/C/figures/action-bars.png"
+ mask="none"
+
style="fill:#eeeeec;fill-opacity:1;stroke:#a7a7a7;stroke-width:0.99999994;stroke-linecap:square;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none;stroke-dashoffset:0"
+ id="rect8909"
+ width="685"
+ height="386"
+ x="127.5"
+ y="609.86218" />
+ <g
+ inkscape:export-ydpi="90"
+ inkscape:export-xdpi="90"
+ inkscape:export-filename="/home/aday/checkout/gnome-devel-docs/hig3/C/figures/action-bars.png"
+ id="g8911"
+ transform="translate(784.0016,581.36218)"
+ style="fill:#888a85;display:inline">
+ <g
+ style="fill:#888a85;display:inline"
+ id="g8913"
+ transform="translate(-60,-518)" />
+ <g
+ id="g8915"
+ transform="translate(-60,-518)"
+ style="fill:#888a85" />
+ <g
+ id="g8917"
+ transform="translate(-60,-518)"
+ style="fill:#888a85" />
+ <g
+ id="g8919"
+ transform="translate(-60,-518)"
+ style="fill:#888a85">
+ <g
+ style="fill:#888a85;display:inline"
+ id="g8921"
+ transform="translate(19,-242)">
+ <path
+
style="font-size:medium;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:normal;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;color:#bebebe;fill:#888a85;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1.78124988;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:new;font-family:Andale
Mono;-inkscape-font-specification:Andale Mono"
+ id="path8923"
+ d="m 45,764 1,0 c 0.01037,-1.2e-4 0.02079,-4.6e-4 0.03125,0 0.254951,0.0112 0.50987,0.12858
0.6875,0.3125 L 49,766.59375 51.3125,764.3125 C 51.578125,764.082 51.759172,764.007 52,764 l 1,0 0,1 c
0,0.28647 -0.03434,0.55065 -0.25,0.75 l -2.28125,2.28125 2.25,2.25 C 52.906938,770.46942 52.999992,770.7347
53,771 l 0,1 -1,0 c -0.265301,-10e-6 -0.530586,-0.0931 -0.71875,-0.28125 L 49,769.4375 46.71875,771.71875 C
46.530586,771.90694 46.26529,772 46,772 l -1,0 0,-1 c -3e-6,-0.26529 0.09306,-0.53058 0.28125,-0.71875 l
2.28125,-2.25 L 45.28125,765.75 C 45.070508,765.55537 44.97809,765.28075 45,765 l 0,-1 z"
+ inkscape:connector-curvature="0" />
+ </g>
+ </g>
+ <g
+ id="g8925"
+ transform="translate(-60,-518)"
+ style="fill:#888a85" />
+ <g
+ id="g8927"
+ transform="translate(-60,-518)"
+ style="fill:#888a85" />
+ <g
+ id="g8929"
+ transform="translate(-60,-518)"
+ style="fill:#888a85" />
+ </g>
+ <path
+ inkscape:export-ydpi="90"
+ inkscape:export-xdpi="90"
+ inkscape:export-filename="/home/aday/checkout/gnome-devel-docs/hig3/C/figures/action-bars.png"
+ inkscape:connector-curvature="0"
+ id="path8931"
+ d="m 771.5,580.85688 0,17.0103"
+
style="fill:none;stroke:#a7a7a7;stroke-width:0.99999988px;stroke-linecap:round;stroke-linejoin:miter;stroke-opacity:1;display:inline"
/>
+ </g>
+ <g
+ id="g3073"
+ transform="translate(40,24)">
+ <rect
+ style="fill:#e5e6e5;fill-opacity:1;stroke:#a7aba7;stroke-width:0.99999994;stroke-opacity:1"
+ id="rect3075"
+ width="685"
+ height="106"
+ x="127.5"
+ y="568.86218"
+ rx="9"
+ ry="9"
+ inkscape:export-filename="/home/aday/checkout/gnome-devel-docs/hig3/C/figures/action-bars.png"
+ inkscape:export-xdpi="90"
+ inkscape:export-ydpi="90" />
+ <rect
+ y="609.86218"
+ x="127.5"
+ height="386"
+ width="685"
+ id="rect3077"
+
style="fill:#eeeeec;fill-opacity:1;stroke:#a7a7a7;stroke-width:0.99999994;stroke-linecap:square;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none;stroke-dashoffset:0"
+ mask="none"
+ inkscape:export-filename="/home/aday/checkout/gnome-devel-docs/hig3/C/figures/action-bars.png"
+ inkscape:export-xdpi="90"
+ inkscape:export-ydpi="90" />
+ <g
+ style="fill:#888a85;display:inline"
+ transform="translate(784.0016,581.36218)"
+ id="g3079"
+ inkscape:export-filename="/home/aday/checkout/gnome-devel-docs/hig3/C/figures/action-bars.png"
+ inkscape:export-xdpi="90"
+ inkscape:export-ydpi="90">
+ <g
+ transform="translate(-60,-518)"
+ id="g3081"
+ style="fill:#888a85;display:inline" />
+ <g
+ style="fill:#888a85"
+ transform="translate(-60,-518)"
+ id="g3083" />
+ <g
+ style="fill:#888a85"
+ transform="translate(-60,-518)"
+ id="g3085" />
+ <g
+ style="fill:#888a85"
+ transform="translate(-60,-518)"
+ id="g3087">
+ <g
+ transform="translate(19,-242)"
+ id="g3089"
+ style="fill:#888a85;display:inline">
+ <path
+ inkscape:connector-curvature="0"
+ d="m 45,764 1,0 c 0.01037,-1.2e-4 0.02079,-4.6e-4 0.03125,0 0.254951,0.0112 0.50987,0.12858
0.6875,0.3125 L 49,766.59375 51.3125,764.3125 C 51.578125,764.082 51.759172,764.007 52,764 l 1,0 0,1 c
0,0.28647 -0.03434,0.55065 -0.25,0.75 l -2.28125,2.28125 2.25,2.25 C 52.906938,770.46942 52.999992,770.7347
53,771 l 0,1 -1,0 c -0.265301,-10e-6 -0.530586,-0.0931 -0.71875,-0.28125 L 49,769.4375 46.71875,771.71875 C
46.530586,771.90694 46.26529,772 46,772 l -1,0 0,-1 c -3e-6,-0.26529 0.09306,-0.53058 0.28125,-0.71875 l
2.28125,-2.25 L 45.28125,765.75 C 45.070508,765.55537 44.97809,765.28075 45,765 l 0,-1 z"
+ id="path3091"
+
style="font-size:medium;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:normal;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;color:#bebebe;fill:#888a85;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1.78124988;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:new;font-family:Andale
Mono;-inkscape-font-specification:Andale Mono" />
+ </g>
+ </g>
+ <g
+ style="fill:#888a85"
+ transform="translate(-60,-518)"
+ id="g3093" />
+ <g
+ style="fill:#888a85"
+ transform="translate(-60,-518)"
+ id="g3095" />
+ <g
+ style="fill:#888a85"
+ transform="translate(-60,-518)"
+ id="g3097" />
+ </g>
+ <path
+
style="fill:none;stroke:#a7a7a7;stroke-width:0.99999988px;stroke-linecap:round;stroke-linejoin:miter;stroke-opacity:1;display:inline"
+ d="m 771.5,580.85688 0,17.0103"
+ id="path3099"
+ inkscape:connector-curvature="0"
+ inkscape:export-filename="/home/aday/checkout/gnome-devel-docs/hig3/C/figures/action-bars.png"
+ inkscape:export-xdpi="90"
+ inkscape:export-ydpi="90" />
+ </g>
+ </g>
+ </g>
+</svg>
diff --git a/hig3/C/primary-windows.page b/hig3/C/primary-windows.page
new file mode 100644
index 0000000..d4f08d8
--- /dev/null
+++ b/hig3/C/primary-windows.page
@@ -0,0 +1,70 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic"
+ id="primary-windows">
+
+ <info>
+ <link type="guide" xref="patterns" group="primary-windows"/>
+ <credit type="author">
+ <name>Allan Day</name>
+ <email>aday gnome org</email>
+ </credit>
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+ </info>
+
+<title>Primary windows</title>
+
+<media type="image" mime="image/svg" src="figures/patterns/primary-windows.svg"/>
+
+<p>Primary windows are the basic high-level container for your application user interface, and should
present the core functionality of your application.</p>
+
+<section id="when-to-use">
+<title>When to use</title>
+
+<p>Every application should have at least one primary window associated with it.</p>
+
+</section>
+
+<section id="application-types">
+<title>Application types</title>
+
+<p>There are two main models for primary windows:</p>
+
+<section id="single-instance-applications">
+<title>Single instance applications</title>
+
+<p>Single instance applications have a single primary window. This model is common for messaging
applications, such as email, chat, or contacts.</p>
+
+</section>
+
+<section id="multiple-instance-applications">
+<title>Multiple instance applications</title>
+
+<p>Multiple instance applications can have a multiple primary windows. Typically, each primary window will
be identical. Multi-instance applications are frequently viewers or editors, such as for documents or
images.</p>
+
+<p>Both single and multiple instance applications can allow multiple content items to be opened, either
through the use of <link xref="tabs">tabs</link> or browser-style navigation. However, multiple windows do
offer additional capabilities, which include:</p>
+
+<list>
+<item><p>Viewing several content items alongside each other.</p></item>
+<item><p>Placing content on different workspaces.</p></item>
+<item><p>Organizing sets of content to be organized into different windows (if using tabs).</p></item>
+</list>
+
+</section>
+</section>
+
+<section id="general-guidelines">
+<title>General guidelines</title>
+
+<list>
+<item><p>If your application isn't running and its launcher is activated, a single primary window should be
displayed. Do not show multiple windows when your application is initially launched.</p></item>
+<item><p>If your application launcher is selected while your application is running, all its primary windows
should be displayed.</p></item>
+<item><p>Primary windows should host the main functionality of your application. Do not rely on dialog or
secondary windows in order to present basic functionality.</p></item>
+<item><p>Primary windows should be independent - closing one primary window should not result in other
primary windows being closed.</p></item>
+<item><p>Dialog windows should always be dependent on a primary window. See the <link xref="dialogs">dialogs
page</link> guidelines.</p></item>
+<item><p>Your application should cease to run when all its primary windows have been closed.</p></item>
+<item><p><gui>Quit</gui> should close all primary windows.</p></item>
+</list>
+
+</section>
+
+</page>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
