[gnome-devel-docs] tutorials python: order of pages in beginner's tutorial reviewed
- From: Marta Maria Casetti <mmcasetti src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gnome-devel-docs] tutorials python: order of pages in beginner's tutorial reviewed
- Date: Mon, 25 Feb 2013 09:24:11 +0000 (UTC)
commit 8c4ea8b854feb499161b10e16365a11e3a037b18
Author: Marta Maria Casetti <mmcasetti gmail com>
Date: Mon Feb 25 10:19:51 2013 +0100
tutorials python: order of pages in beginner's tutorial reviewed
platform-demos/C/buttonbox.py.page | 1 +
platform-demos/C/colorbutton.py.page | 1 +
platform-demos/C/combobox.py.page | 3 +-
platform-demos/C/combobox_multicolumn.py.page | 3 +-
platform-demos/C/filechooserdialog.py.page | 1 +
platform-demos/C/fontchooserwidget.py.page | 1 +
platform-demos/C/gmenu.py.page | 1 +
platform-demos/C/menubar.py.page | 3 +-
platform-demos/C/menubutton.py.page | 1 +
platform-demos/C/messagedialog.py.page | 3 +-
platform-demos/C/model-view-controller.py.page | 1 +
platform-demos/C/paned.py.page | 1 +
platform-demos/C/radiobutton.py.page | 2 +-
platform-demos/C/scrolledwindow.py.page | 2 +-
platform-demos/C/toolbar.py.page | 1 +
platform-demos/C/tooltip.py.page | 1 +
.../C/treeview_advanced_liststore.py.page | 5 ++-
.../C/treeview_cellrenderertoggle.py.page | 3 +-
platform-demos/C/treeview_simple_liststore.py.page | 3 +-
platform-demos/C/treeview_treestore.py.page | 3 +-
platform-demos/C/tutorial.py.page | 37 +++++++++-----------
platform-demos/C/window.py.page | 2 +-
22 files changed, 47 insertions(+), 32 deletions(-)
---
diff --git a/platform-demos/C/buttonbox.py.page b/platform-demos/C/buttonbox.py.page
index ee9d31d..74b1074 100644
--- a/platform-demos/C/buttonbox.py.page
+++ b/platform-demos/C/buttonbox.py.page
@@ -7,6 +7,7 @@
<title type="text">ButtonBox (Python)</title>
<link type="guide" xref="beginner.py#layout"/>
<link type="seealso" xref="button.py"/>
+ <link type="next" xref="statusbar.py"/>
<revision version="0.2" date="2012-08-01" status="stub"/>
<credit type="author copyright">
diff --git a/platform-demos/C/colorbutton.py.page b/platform-demos/C/colorbutton.py.page
index 1940524..5b4d1bf 100644
--- a/platform-demos/C/colorbutton.py.page
+++ b/platform-demos/C/colorbutton.py.page
@@ -6,6 +6,7 @@
<info>
<title type="text">ColorButton (Python)</title>
<link type="guide" xref="beginner.py#color-selectors"/>
+ <link type="next" xref="fontchooserwidget.py"/>
<revision version="0.1" date="2012-06-03" status="draft"/>
<credit type="author copyright">
diff --git a/platform-demos/C/combobox.py.page b/platform-demos/C/combobox.py.page
index d8b7c05..6a1aa58 100644
--- a/platform-demos/C/combobox.py.page
+++ b/platform-demos/C/combobox.py.page
@@ -6,6 +6,7 @@
<info>
<title type="text">ComboBox (Python)</title>
<link type="guide" xref="beginner.py#menu-combo-toolbar"/>
+ <link type="next" xref="treeview_simple_liststore.py"/>
<revision version="0.1" date="2012-06-02" status="draft"/>
<credit type="author copyright">
@@ -30,7 +31,7 @@
<section id="methods">
<title>Useful methods for a ComboBox widget</title>
- <p>The ComboBox widget is designed around a <em>Model/View/Controller</em> design. For more information,
and for a list of useful methods for ComboBox and TreeModel, see <link
xref="model-view-controller.py">here</link>.</p>
+ <p>The ComboBox widget is designed around a <em>Model/View/Controller</em> design: the <em>Model</em>
stores the data; the <em>View</em> gets change notifications and displays the content of the model; the
<em>Controller</em>, finally, changes the state of the model and notifies the view of these changes. For more
information, and for a list of useful methods for ComboBox and TreeModel, see <link
xref="model-view-controller.py" />.</p>
</section>
<section id="references">
diff --git a/platform-demos/C/combobox_multicolumn.py.page b/platform-demos/C/combobox_multicolumn.py.page
index 362aa11..bdee2c1 100644
--- a/platform-demos/C/combobox_multicolumn.py.page
+++ b/platform-demos/C/combobox_multicolumn.py.page
@@ -7,6 +7,7 @@
<title type="text">ComboBox (Python)</title>
<link type="guide" xref="beginner.py#menu-combo-toolbar"/>
<link type="seealso" xref="combobox.py"/>
+ <link type="next" xref="treeview_advanced_liststore.py"/>
<revision version="0.1" date="2012-06-03" status="draft"/>
<credit type="author copyright">
@@ -32,7 +33,7 @@
<section id="methods">
<title>Useful methods for a ComboBox widget</title>
- <p>The ComboBox widget is designed around a <em>Model/View/Controller</em> design. For more information,
and for a list of useful methods for ComboBox and TreeModel, see <link
xref="model-view-controller.py">here</link>.</p>
+ <p>The ComboBox widget is designed around a <em>Model/View/Controller</em> design: the <em>Model</em>
stores the data; the <em>View</em> gets change notifications and displays the content of the model; the
<em>Controller</em>, finally, changes the state of the model and notifies the view of these changes. For more
information, and for a list of useful methods for ComboBox and TreeModel, see <link
xref="model-view-controller.py" />.</p>
</section>
diff --git a/platform-demos/C/filechooserdialog.py.page b/platform-demos/C/filechooserdialog.py.page
index 5050c1c..96ddbb3 100644
--- a/platform-demos/C/filechooserdialog.py.page
+++ b/platform-demos/C/filechooserdialog.py.page
@@ -9,6 +9,7 @@
<link type="seealso" xref="gmenu.py"/>
<link type="seealso" xref="toolbar_builder.py"/>
<link type="seealso" xref="textview.py"/>
+ <link type="next" xref="combobox.py"/>
<revision version="0.1" date="2012-08-14" status="draft"/>
<credit type="author copyright">
diff --git a/platform-demos/C/fontchooserwidget.py.page b/platform-demos/C/fontchooserwidget.py.page
index 4b7247d..a10070f 100644
--- a/platform-demos/C/fontchooserwidget.py.page
+++ b/platform-demos/C/fontchooserwidget.py.page
@@ -7,6 +7,7 @@
<title type="text">FontChooserWidget (Python)</title>
<link type="guide" xref="beginner.py#font-selectors"/>
<link type="seealso" xref="signals-callbacks.py"/>
+ <link type="next" xref="filechooserdialog.py"/>
<revision version="0.2" date="2012-05-05" status="draft"/>
<credit type="author copyright">
diff --git a/platform-demos/C/gmenu.py.page b/platform-demos/C/gmenu.py.page
index 3cecd3c..9f06a7e 100644
--- a/platform-demos/C/gmenu.py.page
+++ b/platform-demos/C/gmenu.py.page
@@ -6,6 +6,7 @@
<info>
<title type="text">GMenu (Python)</title>
<link type="guide" xref="beginner.py#menu-combo-toolbar"/>
+ <link type="next" xref="menubutton.py"/>
<revision version="0.1" date="2012-04-28" status="draft"/>
<credit type="author copyright">
diff --git a/platform-demos/C/menubar.py.page b/platform-demos/C/menubar.py.page
index aac2048..9b91296 100644
--- a/platform-demos/C/menubar.py.page
+++ b/platform-demos/C/menubar.py.page
@@ -8,6 +8,7 @@
<link type="guide" xref="beginner.py#menu-combo-toolbar"/>
<link type="seealso" xref="aboutdialog.py"/>
<link type="seealso" xref="gmenu.py"/>
+ <link type="next" xref="colorbutton.py"/>
<revision version="0.1" date="2012-08-01" status="stub"/>
<credit type="author copyright">
@@ -24,7 +25,7 @@
<desc>A widget which holds GtkMenuItem widgets</desc>
</info>
- <title>MenuBar</title>
+ <title>MenuBar - using XML and GtkBuilder</title>
<media type="image" mime="image/png" src="media/menubar.png"/>
<p>A MenuBar created using XML and GtkBuilder.</p>
diff --git a/platform-demos/C/menubutton.py.page b/platform-demos/C/menubutton.py.page
index d03f342..a25f307 100644
--- a/platform-demos/C/menubutton.py.page
+++ b/platform-demos/C/menubutton.py.page
@@ -6,6 +6,7 @@
<info>
<title type="text">MenuButton</title>
<link type="guide" xref="beginner.py#buttons"/>
+ <link type="next" xref="toolbar.py"/>
<revision version="0.1" date="2012-08-19" status="draft"/>
<credit type="author copyright">
diff --git a/platform-demos/C/messagedialog.py.page b/platform-demos/C/messagedialog.py.page
index bd00377..bdc049b 100644
--- a/platform-demos/C/messagedialog.py.page
+++ b/platform-demos/C/messagedialog.py.page
@@ -7,6 +7,7 @@
<title type="text">MessageDialog (Python)</title>
<link type="guide" xref="beginner.py#windows"/>
<link type="seealso" xref="signals-callbacks.py"/>
+ <link type="next" xref="gmenu.py"/>
<revision version="0.1" date="2012-06-11" status="draft"/>
<credit type="author copyright">
@@ -33,7 +34,7 @@
<section id="methods">
<title>Useful methods for a MessageDialog widget</title>
- <p>For an explanation of signals and callback functions, see <link xref="signals-callbacks.py">this
page</link>.</p>
+ <p>For an explanation of signals and callback functions, see <link xref="signals-callbacks.py" />.</p>
<list>
<item><p>In the constructor of MessageDialog we could set flags as
<code>Gtk.DialogFlags.DESTROY_WITH_PARENT</code> (to destroy the messagedialog window when its parent window
is destroyed) or as <code>Gtk.DialogFlags.MODAL</code> (no interaction with other windows of the
application).</p></item>
<item><p>In the constructor of MessageDialog we could set type as any of <code>Gtk.MessageType.INFO,
Gtk.MessageType.WARNING, Gtk.MessageType.QUESTION, Gtk.MessageType.ERROR, Gtk.MessageType.OTHER</code>
depending on what type of message we want.</p></item>
diff --git a/platform-demos/C/model-view-controller.py.page b/platform-demos/C/model-view-controller.py.page
index a1e2767..d3512d6 100644
--- a/platform-demos/C/model-view-controller.py.page
+++ b/platform-demos/C/model-view-controller.py.page
@@ -7,6 +7,7 @@
<info>
<title type="text">The Model/View/Controller design (Python)</title>
<link type="guide" xref="beginner.py#theory"/>
+ <link type="next" xref="combobox_multicolumn.py"/>
<revision version="0.1" date="2012-06-30" status="stub"/>
<desc>The Model/View/Controller design</desc>
diff --git a/platform-demos/C/paned.py.page b/platform-demos/C/paned.py.page
index 9f77b31..03c348b 100644
--- a/platform-demos/C/paned.py.page
+++ b/platform-demos/C/paned.py.page
@@ -6,6 +6,7 @@
<info>
<title type="text">Paned (Python)</title>
<link type="guide" xref="beginner.py#layout"/>
+ <link type="next" xref="signals-callbacks.py"/>
<revision version="0.1" date="2012-08-15" status="draft"/>
<credit type="author copyright">
diff --git a/platform-demos/C/radiobutton.py.page b/platform-demos/C/radiobutton.py.page
index 2e46f39..09a3260 100644
--- a/platform-demos/C/radiobutton.py.page
+++ b/platform-demos/C/radiobutton.py.page
@@ -9,7 +9,7 @@
<link type="seealso" xref="signals-callbacks.py"/>
<link type="seealso" xref="togglebutton.py"/>
<link type="seealso" xref="grid.py"/>
- <link type="next" xref="statusbar.py"/>
+ <link type="next" xref="buttonbox.py"/>
<revision version="0.1" date="2012-05-09" status="draft"/>
<credit type="author copyright">
diff --git a/platform-demos/C/scrolledwindow.py.page b/platform-demos/C/scrolledwindow.py.page
index af1848c..68b8b92 100644
--- a/platform-demos/C/scrolledwindow.py.page
+++ b/platform-demos/C/scrolledwindow.py.page
@@ -6,7 +6,7 @@
<info>
<title type="text">ScrolledWindow (Python)</title>
<link type="guide" xref="beginner.py#scrolling"/>
- <link type="next" xref="signals-callbacks.py"/>
+ <link type="next" xref="paned.py"/>
<revision version="0.1" date="2012-05-26" status="draft"/>
<credit type="author copyright">
diff --git a/platform-demos/C/toolbar.py.page b/platform-demos/C/toolbar.py.page
index d512ade..94085c2 100644
--- a/platform-demos/C/toolbar.py.page
+++ b/platform-demos/C/toolbar.py.page
@@ -7,6 +7,7 @@
<title type="text">Toolbar (Python)</title>
<link type="guide" xref="beginner.py#menu-combo-toolbar"/>
<link type="seealso" xref="grid.py"/>
+ <link type="next" xref="tooltip.py"/>
<revision version="0.1" date="2012-06-05" status="draft"/>
<credit type="author copyright">
diff --git a/platform-demos/C/tooltip.py.page b/platform-demos/C/tooltip.py.page
index af61402..04d8f7a 100644
--- a/platform-demos/C/tooltip.py.page
+++ b/platform-demos/C/tooltip.py.page
@@ -7,6 +7,7 @@
<title type="text">MenuButton</title>
<link type="guide" xref="beginner.py#misc"/>
<link type="seealso" xref="toolbar.py"/>
+ <link type="next" xref="toolbar_builder.py"/>
<revision version="0.1" date="2012-08-20" status="draft"/>
<credit type="author copyright">
diff --git a/platform-demos/C/treeview_advanced_liststore.py.page
b/platform-demos/C/treeview_advanced_liststore.py.page
index 6e0abc8..ba396d0 100644
--- a/platform-demos/C/treeview_advanced_liststore.py.page
+++ b/platform-demos/C/treeview_advanced_liststore.py.page
@@ -9,6 +9,7 @@
<link type="seealso" xref="grid.py"/>
<link type="seealso" xref="label.py"/>
<link type="seealso" xref="button.py"/>
+ <link type="next" xref="treeview_cellrenderertoggle.py"/>
<revision version="0.1" date="2012-06-30" status="draft"/>
<credit type="author copyright">
@@ -34,8 +35,8 @@
<section id="methods">
<title>Useful methods for a TreeView widget</title>
- <p>The TreeView widget is designed around a <em>Model/View/Controller</em> design. For more information,
and for a list of useful methods for TreeView and the interface TreeModel, see <link
xref="model-view-controller.py">here</link>.</p>
- <p>For buttons and callbacks functions, see <link xref="signals-callbacks.py">here</link></p>
+ <p>The TreeView widget is designed around a <em>Model/View/Controller</em> design: the <em>Model</em>
stores the data; the <em>View</em> gets change notifications and displays the content of the model; the
<em>Controller</em>, finally, changes the state of the model and notifies the view of these changes. For more
information, and for a list of useful methods for ComboBox and TreeModel, see <link
xref="model-view-controller.py" />.</p>
+ <p>For buttons and callbacks functions, see <link xref="signals-callbacks.py" /></p>
</section>
<section id="references">
diff --git a/platform-demos/C/treeview_cellrenderertoggle.py.page
b/platform-demos/C/treeview_cellrenderertoggle.py.page
index 212132b..d0f277a 100644
--- a/platform-demos/C/treeview_cellrenderertoggle.py.page
+++ b/platform-demos/C/treeview_cellrenderertoggle.py.page
@@ -6,6 +6,7 @@
<info>
<title type="text">TreeView with TreeStore (Python)</title>
<link type="guide" xref="beginner.py#treeview"/>
+ <link type="next" xref="widget_drawing.py"/>
<revision version="0.1" date="2012-06-30" status="draft"/>
<credit type="author copyright">
@@ -31,7 +32,7 @@
<section id="methods">
<title>Useful methods for a TreeView widget</title>
- <p>The TreeView widget is designed around a <em>Model/View/Controller</em> design. For more information,
and for a list of useful methods for TreeView and the interface TreeModel, see <link
xref="model-view-controller.py">here</link>.</p>
+ <p>The TreeView widget is designed around a <em>Model/View/Controller</em> design: the <em>Model</em>
stores the data; the <em>View</em> gets change notifications and displays the content of the model; the
<em>Controller</em>, finally, changes the state of the model and notifies the view of these changes. For more
information, and for a list of useful methods for ComboBox and TreeModel, see <link
xref="model-view-controller.py" />.</p>
</section>
<section id="references">
diff --git a/platform-demos/C/treeview_simple_liststore.py.page
b/platform-demos/C/treeview_simple_liststore.py.page
index e5eff4f..f74a39d 100644
--- a/platform-demos/C/treeview_simple_liststore.py.page
+++ b/platform-demos/C/treeview_simple_liststore.py.page
@@ -8,6 +8,7 @@
<link type="guide" xref="beginner.py#treeview"/>
<link type="seealso" xref="grid.py"/>
<link type="seealso" xref="label.py"/>
+ <link type="next" xref="treeview_treestore.py"/>
<revision version="0.2" date="2012-06-30" status="draft"/>
<credit type="author copyright">
@@ -33,7 +34,7 @@
<section id="methods">
<title>Useful methods for a TreeView widget</title>
- <p>The TreeView widget is designed around a <em>Model/View/Controller</em> design. For more information,
and for a list of useful methods for TreeView and the interface TreeModel, see <link
xref="model-view-controller.py">here</link>.</p>
+ <p>The TreeView widget is designed around a <em>Model/View/Controller</em> design: the <em>Model</em>
stores the data; the <em>View</em> gets change notifications and displays the content of the model; the
<em>Controller</em>, finally, changes the state of the model and notifies the view of these changes. For more
information, and for a list of useful methods for ComboBox and TreeModel, see <link
xref="model-view-controller.py" />.</p>
</section>
<section id="references">
diff --git a/platform-demos/C/treeview_treestore.py.page b/platform-demos/C/treeview_treestore.py.page
index 435b93e..b3d5a43 100644
--- a/platform-demos/C/treeview_treestore.py.page
+++ b/platform-demos/C/treeview_treestore.py.page
@@ -6,6 +6,7 @@
<info>
<title type="text">TreeView with TreeStore (Python)</title>
<link type="guide" xref="beginner.py#treeview"/>
+ <link type="next" xref="model-view-controller.py"/>
<revision version="0.1" date="2012-06-30" status="draft"/>
<credit type="author copyright">
@@ -31,7 +32,7 @@
<section id="methods">
<title>Useful methods for a TreeView widget</title>
- <p>The TreeView widget is designed around a <em>Model/View/Controller</em> design. For more information,
and for a list of useful methods for TreeView and the interface TreeModel, see <link
xref="model-view-controller.py">here</link>.</p>
+ <p>The TreeView widget is designed around a <em>Model/View/Controller</em> design: the <em>Model</em>
stores the data; the <em>View</em> gets change notifications and displays the content of the model; the
<em>Controller</em>, finally, changes the state of the model and notifies the view of these changes. For more
information, and for a list of useful methods for ComboBox and TreeModel, see <link
xref="model-view-controller.py" />.</p>
</section>
<section id="references">
diff --git a/platform-demos/C/tutorial.py.page b/platform-demos/C/tutorial.py.page
index 8fd3735..4e27573 100644
--- a/platform-demos/C/tutorial.py.page
+++ b/platform-demos/C/tutorial.py.page
@@ -68,6 +68,7 @@
<item><p><link xref="grid.py" /></p></item>
<item><p><link xref="separator.py" /></p></item>
<item><p><link xref="scrolledwindow.py" /></p></item>
+ <item><p><link xref="paned.py" /></p></item>
</steps></item>
<item><steps>
<title>Signals, callbacks and buttons</title>
@@ -80,6 +81,10 @@
<item><p><link xref="radiobutton.py" /></p></item>
</steps></item>
<item><steps>
+ <title>ButtonBox</title>
+ <item><p><link xref="buttonbox.py" /></p></item>
+ </steps></item>
+ <item><steps>
<title>Other display widgets</title>
<item><p><link xref="statusbar.py" /></p></item>
<item><p><link xref="spinner.py" /></p></item>
@@ -102,37 +107,29 @@
<item><p><link xref="messagedialog.py" /></p></item>
</steps></item>
<item><steps>
- <title>TreeViews and ComboBoxes (using the M/V/C design)</title>
- <item><p><link xref="combobox.py" /></p></item>
- <item><p><link xref="combobox_multicolumn.py" /></p></item>
- <item><p><link xref="treeview_simple_liststore.py" /></p></item>
- <item><p><link xref="treeview_advanced_liststore.py" /></p></item>
- <item><p><link xref="treeview_treestore.py" /></p></item>
- <item><p><link xref="treeview_cellrenderertoggle.py" /></p></item>
- <item><p><link xref="model-view-controller.py" /></p></item>
- </steps></item>
- <item><steps>
- <title>Menus and toolbars (also: using Glade)</title>
+ <title>Menus, Toolbars and Tooltips (also: using Glade and GtkBuilder)</title>
<item><p><link xref="gmenu.py" /></p></item>
+ <item><p><link xref="menubutton.py" /></p></item>
<item><p><link xref="toolbar.py" /></p></item>
+ <item><p><link xref="tooltip.py" /></p></item>
<item><p><link xref="toolbar_builder.py" /></p></item>
<item><p><link xref="menubar.py" /></p></item>
- <item><p><link xref="menubutton.py" /></p></item>
</steps></item>
<item><steps>
- <title>Selectors (a recap)</title>
+ <title>Selectors</title>
<item><p><link xref="colorbutton.py" /></p></item>
<item><p><link xref="fontchooserwidget.py" /></p></item>
<item><p><link xref="filechooserdialog.py" /></p></item>
</steps></item>
<item><steps>
- <title>Tooltip</title>
- <item><p><link xref="tooltip.py" /></p></item>
- </steps></item>
- <item><steps>
- <title>More containers</title>
- <item><p><link xref="paned.py" /></p></item>
- <item><p><link xref="buttonbox.py" /></p></item>
+ <title>TreeViews and ComboBoxes (using the M/V/C design)</title>
+ <item><p><link xref="combobox.py" /></p></item>
+ <item><p><link xref="treeview_simple_liststore.py" /></p></item>
+ <item><p><link xref="treeview_treestore.py" /></p></item>
+ <item><p><link xref="model-view-controller.py" /></p></item>
+ <item><p><link xref="combobox_multicolumn.py" /></p></item>
+ <item><p><link xref="treeview_advanced_liststore.py" /></p></item>
+ <item><p><link xref="treeview_cellrenderertoggle.py" /></p></item>
</steps></item>
<item><steps>
<title>Custom widget</title>
diff --git a/platform-demos/C/window.py.page b/platform-demos/C/window.py.page
index 8a9df00..ad971cb 100644
--- a/platform-demos/C/window.py.page
+++ b/platform-demos/C/window.py.page
@@ -48,7 +48,7 @@
<section id="methods">
<title>Useful methods for a Window widget</title>
- <p><code>window = Gtk.Window(application=self, title="Welcome to GNOME")</code> sets the title as well,
without the need for the line <code>window.set_title("Welcome to GNOME")</code>. For a general discussion of
this, see <link xref="properties.py">here</link>.</p>
+ <p><code>window = Gtk.Window(application=self, title="Welcome to GNOME")</code> sets the title as well,
without the need for the line <code>window.set_title("Welcome to GNOME")</code>. For a general discussion of
this, see <link xref="properties.py" />.</p>
<list>
<item><p><code>set_default_size(200, 100)</code> sets the default size of the window to a width of
<code>200</code> and a height of <code>100</code>; if instead of a positive number we pass <code>-1</code> we
have the default size.</p></item>
<item><p><code>set_position(Gtk.WindowPosition.CENTER)</code> centers the window. Other options are
<code>Gtk.WindowPosition.NONE, Gtk.WindowPosition.MOUSE, Gtk.WindowPosition.CENTER_ALWAYS,
Gtk.WindowPosition.CENTER_ON_PARENT</code>.</p></item>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
