diff --git a/README.md b/README.md index b4f2e87..4adddce 100644 --- a/README.md +++ b/README.md @@ -13,40 +13,43 @@ The table of contents is at the end of this abstract. - Section 26 to 29 describes the list model and the list view (GtkListView, GtkGridView and GtkColumnView). It also describes GtkExpression. -The latest version of the tutorial is located at [Gtk4-tutorial GitHub repository](https://github.com/ToshioCP/Gtk4-tutorial). -You can read it from there directly without having to download anything. +The latest version of the tutorial is located at [GTK4-tutorial GitHub repository](https://github.com/ToshioCP/GTK4-tutorial). +You can read it directly without download. + +There's a GitHub Page of this tutorial at [`https://toshiocp.github.io/GTK4-tutorial/`](https://toshiocp.github.io/GTK4-tutorial/). +It is easier to read than the repository. #### GTK 4 Documentation -Please refer to [GTK API Reference](https://docs.gtk.org/gtk4/index.html) +Please refer to [GTK 4 API Reference](https://docs.gtk.org/gtk4/index.html) and [GNOME Developer Documentation Website](https://developer.gnome.org/) for further information. -These websites are newly opened lately (Aug/2021). -The old documentation is located at [GTK Reference Manual](https://developer-old.gnome.org/gtk4/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. +These websites were opened in August of 2021. +The old documents are located at [GTK Reference Manual](https://developer-old.gnome.org/gtk4/stable/) and [GNOME Developer Center](https://developer-old.gnome.org/). If you want to know about GObject and the type system, please refer to [GObject tutorial](https://github.com/ToshioCP/Gobject-tutorial). -The GObject details are easy to understand and also necessary to know when writing GTK 4 programs. +GObject is the base of GTK 4, so it is important for developers to understand GObject for writing GTK 4 programs. #### Contribution -This tutorial is under development and unstable. -Even though the codes of the examples have been tested on GTK 4 (version 4.0), bugs may still exist. +This tutorial is still under development and unstable. +Even though the codes of the examples have been tested on GTK 4 (version 4.8.1), bugs may still exist. 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). -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, -then run `rake` to create to create the output file. The GFM files under the 'gfm' directory are automatically updated. +You can post it to [GitHub issues](https://github.com/ToshioCP/GTK4-tutorial/issues). +You can also post updated files to [pull request](https://github.com/ToshioCP/GTK4-tutorial/pulls). +One thing you need to be careful is to correct the source files, which are under the 'src' directory. +Don't modify the files under `gfm` or `html` directories. +After modifying some source files (under `src` directory), run `rake` to create GFM (GitHub Flavoured Markdown) files or run `rake html` to create HTML files. -If you have a question, feel free to post it as an issue. +If you have a question, feel free to post it to `issue`. All questions are helpful and will make this tutorial get better. -#### How to get a HTML or PDF version +#### How to get Gtk 4 tutorial with HTML or PDF format -If you want to get a HTML or PDF version, you can make them with `rake`, which is a ruby version of make. +If you want to get HTML or PDF format tutorial, make them with `rake` command, which is a ruby version of make. Type `rake html` for HTML. Type `rake pdf` for PDF. -There is a documentation \("[How to build GTK 4 Tutorial](gfm/Readme_for_developers.md)"\) that describes how to make them. +There is a document \("[How to build GTK 4 Tutorial](gfm/Readme_for_developers.md)"\) for further information. ## Table of contents @@ -55,17 +58,17 @@ There is a documentation \("[How to build GTK 4 Tutorial](gfm/Readme_for_develop 1. [GtkApplication and GtkApplicationWindow](gfm/sec3.md) 1. [Widgets (1)](gfm/sec4.md) 1. [Widgets (2)](gfm/sec5.md) -1. [String and memory management](gfm/sec6.md) +1. [Strings and memory management](gfm/sec6.md) 1. [Widgets (3)](gfm/sec7.md) -1. [Defining a child object](gfm/sec8.md) -1. [The User Interface (UI) file and GtkBuilder](gfm/sec9.md) +1. [Defining a final class](gfm/sec8.md) +1. [GtkBuilder and UI file](gfm/sec9.md) 1. [Build system](gfm/sec10.md) -1. [Initialization and destruction of instances](gfm/sec11.md) +1. [Instance Initialization and destruction](gfm/sec11.md) 1. [Signals](gfm/sec12.md) 1. [Functions in TfeTextView](gfm/sec13.md) 1. [Functions in GtkNotebook](gfm/sec14.md) 1. [tfeapplication.c](gfm/sec15.md) -1. [tfe5 source files](gfm/sec16.md) +1. [How to build tfe (text file editor)](gfm/sec16.md) 1. [Menu and action](gfm/sec17.md) 1. [Stateful action](gfm/sec18.md) 1. [Ui file for menu and action entries](gfm/sec19.md) diff --git a/docs/image/TfeTextViewClass.png b/docs/image/TfeTextViewClass.png index 35cebea..136def7 100644 Binary files a/docs/image/TfeTextViewClass.png and b/docs/image/TfeTextViewClass.png differ diff --git a/docs/image/screenshot_lb4.png b/docs/image/screenshot_lb4.png index 243ddd7..9ee5b4a 100644 Binary files a/docs/image/screenshot_lb4.png and b/docs/image/screenshot_lb4.png differ diff --git a/docs/index.html b/docs/index.html index 15795ee..d101682 100644 --- a/docs/index.html +++ b/docs/index.html @@ -116,44 +116,46 @@ editor tfe (Text File Editor). GtkExpression.

The latest version of the tutorial is located at Gtk4-tutorial GitHub -repository. You can read it from there directly without having to -download anything.

+href="https://github.com/ToshioCP/GTK4-tutorial">GTK4-tutorial GitHub +repository. You can read it directly without download.

+

There’s a GitHub Page of this tutorial at https://toshiocp.github.io/GTK4-tutorial/. +It is easier to read than the repository.

GTK 4 Documentation

-

Please refer to GTK +

Please refer to GTK 4 API Reference and GNOME Developer Documentation Website for further information.

-

These websites are newly opened lately (Aug/2021). The old -documentation is located at GTK Reference -Manual and GNOME -Developer Center. The new website is in progress at present, so you -might need to refer to the old version.

+

These websites were opened in August of 2021. The old documents are +located at GTK +Reference Manual and GNOME Developer Center.

If you want to know about GObject and the type system, please refer to GObject -tutorial. The GObject details are easy to understand and also -necessary to know when writing GTK 4 programs.

+tutorial. GObject is the base of GTK 4, so it is important for +developers to understand GObject for writing GTK 4 programs.

Contribution

-

This tutorial is under development and unstable. Even though the -codes of the examples have been tested on GTK 4 (version 4.0), bugs may -still exist. 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. You can also post corrected files as a commit to pull request. -When you make corrections, correct the source files, which are under the -‘src’ directory, then run rake to create to create the -output file. The GFM files under the ‘gfm’ directory are automatically -updated.

-

If you have a question, feel free to post it as an issue. All -questions are helpful and will make this tutorial get better.

-

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 +

This tutorial is still under development and unstable. Even though +the codes of the examples have been tested on GTK 4 (version 4.8.1), +bugs may still exist. 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. You can also post updated files to pull request. +One thing you need to be careful is to correct the source files, which +are under the ‘src’ directory. Don’t modify the files under +gfm or html directories. After modifying some +source files (under src directory), run rake +to create GFM (GitHub Flavoured Markdown) files or run +rake html to create HTML files.

+

If you have a question, feel free to post it to issue. +All questions are helpful and will make this tutorial get better.

+

How to get +Gtk 4 tutorial with HTML or PDF format

+

If you want to get HTML or PDF format tutorial, make them with +rake command, which is a ruby version of make. Type rake html for HTML. Type rake pdf for PDF. -There is a documentation (“How to -build GTK 4 Tutorial”) that describes how to make them.

+There is a document (“How to build +GTK 4 Tutorial”) for further information.

Table of contents

  1. Prerequisite and License
    2. @@ -162,19 +164,18 @@ distributions
  2. GtkApplication and GtkApplicationWindow
  3. Widgets (1)
  4. Widgets (2)
    5. -
  5. String and memory management
    6. +
  6. Strings and memory management
  7. Widgets (3)
    8. -
  8. Defining a child object
    9. -
  9. The User Interface (UI) file and -GtkBuilder
    10. +
  10. Defining a final class
    11. +
  11. GtkBuilder and UI file
  12. Build system
    13. -
  13. Initialization and destruction of -instances
    14. +
  14. Instance Initialization and +destruction
  15. Signals
  16. Functions in TfeTextView
  17. Functions in GtkNotebook
  18. tfeapplication.c
    19. -
  19. tfe5 source files
    20. +
  20. How to build tfe (text file editor)
  21. Menu and action
  22. Stateful action
  23. Ui file for menu and action entries
    24. diff --git a/docs/sec1.html b/docs/sec1.html index ffc977b..5786a83 100644 --- a/docs/sec1.html +++ b/docs/sec1.html @@ -117,36 +117,37 @@ MacOS, with Vala, Python and so on. However, this tutorial describes only C programs on Linux.

    If you want to try the examples in the tutorial, you need:

    Ruby and rake for making the document

    -

    This repository includes Ruby programs. They are used to make -Markdown files, HTML files, Latex files and a PDF file.

    +

    This repository includes Ruby programs. They are used to make GFM +(GitHub Flavoured Markdown) files, HTML files, Latex files and a PDF +file.

    You need:

    License

    -

    Copyright (C) 2020 ToshioCP (Toshio Sekiya)

    -

    Gtk4-tutorial repository contains the tutorial document and software +

    Copyright (C) 2020-2022 ToshioCP (Toshio Sekiya)

    +

    GTK4-tutorial repository contains tutorial documents and programs such as converters, generators and controllers. All of them make up the -‘Gtk4-tutorial’ package. This package is simply called ‘Gtk4-tutorial’ -in the following description. ‘Gtk4-tutorial’ is free; you can +‘GTK4-tutorial’ package. This package is simply called ‘GTK4-tutorial’ +in the following description. ‘GTK4-tutorial’ is free; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License or, at your option, any later version.

    -

    ‘Gtk4-tutorial’ is distributed in the hope that it will be useful, +

    ‘GTK4-tutorial’ is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public diff --git a/docs/sec10.html b/docs/sec10.html index 6a276ed..1cc6c83 100644 --- a/docs/sec10.html +++ b/docs/sec10.html @@ -5,7 +5,7 @@ - Gtk4 tutorial + GTK 4 tutorial