Gtk4-tutorial/src/abstract.src.md

53 lines
2.6 KiB
Markdown
Raw Normal View History

2021-08-12 07:04:22 +02:00
#### Contents of this repository
This tutorial illustrates how to write C programs with Gtk4 library.
2021-04-19 14:24:12 +02:00
It focuses on beginners so the contents are limited to basic things.
The table of contents are shown at the end of this abstract.
- Section 3 to 20 describes basics and the example is a simple editor `tfe` (Text File Editor).
- Section 21 to 23 describes GtkDrawingArea.
- Section 24 to 27 describes list model and list view (GtkListView, GtkGridView and GtkColumnView).
It also describes GtkExpression.
2021-08-12 07:04:22 +02:00
The latest version of the tutorial is located at [Gtk4-tutorial github repository](https://github.com/ToshioCP/Gtk4-tutorial).
You can read it without download.
#### Gtk4 Documentation
Please refer to [Gtk API Reference](https://docs.gtk.org/gtk4/index.html)
and [Gnome Developer Documentation Website](https://developer.gnome.org/) for further topics.
These websites are newly opend lately (Aug/2021).
The old documentation is located at [Gtk Reference Manual](https://developer-old.gnome.org/gdk4/stable/) and [Gnome Developer Center](https://developer-old.gnome.org/).
The new website is in progress at present, so you might need to refer to the old version.
2021-07-17 17:00:20 +02:00
If you want to know about GObject and type system, refer to [GObject tutorial](https://github.com/ToshioCP/Gobject-tutorial).
2021-08-12 07:04:22 +02:00
They are basic and also necessary to write Gtk4 programs.
#### Contribution
2021-07-17 17:00:20 +02:00
This tutorial is under development and unstable.
2021-08-12 07:04:22 +02:00
Even though the codes of the examples have been tested on Gtk4 version 4.0, there might exist bugs.
If you find any bugs, errors or mistakes in the tutorial and C examples, please let me know.
You can post it to [github issues](https://github.com/ToshioCP/Gtk4-tutorial/issues).
2021-08-12 07:04:22 +02:00
You can also post corrected files as a commit to [pull request](https://github.com/ToshioCP/Gtk4-tutorial/pulls).
When you make corrections, correct the source files, which are under the 'src' directory.
And run rake, then GFM files under the 'gfm' directory are automatically updated.
If you have a question, feel free to post it to the issue.
Any question is helpful to make this tutorial get better.
2021-08-12 07:04:22 +02:00
#### How to get a HTML or PDF version
If you want to get a HTML or PDF version, you can make them with `rake`, which is a ruby version of make.
Type `rake html` for HTML.
Type `rake pdf` for PDF.
@@@if gfm
There is a documentation \("[How to build Gtk4 Tutorial](Readme_for_developers.src.md)"\) that describes how to make them.
@@@elif html
There is a documentation \("[How to build Gtk4 Tutorial](Readme_for_developers.src.md)"\) that describes how to make them.
@@@elif latex
An appendix "How to build Gtk4 Tutorial" describes how to make them.
@@@end
2021-04-19 14:24:12 +02:00