[gtk-web/new-website: 122/191] added new doc pages
- From: Emmanuele Bassi <ebassi src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk-web/new-website: 122/191] added new doc pages
- Date: Thu, 21 Nov 2019 12:28:43 +0000 (UTC)
commit 3f037102842db760cb1461c85767eba3911eb1ba
Author: ravgeetdhillon <ravgeetdhillon gmail com>
Date: Tue Jul 23 14:00:23 2019 +0530
added new doc pages
_includes/header.html | 8 ++--
assets/img/docs/doc-gtk-windows.png | Bin 12803 -> 0 bytes
.../img/docs/{doc-builder.png => docs-builder.png} | Bin
.../img/docs/{doc-eclipse.png => docs-eclipse.png} | Bin
...-architecture.png => docs-gtk-architecture.png} | Bin
assets/img/docs/docs-gtk-linux.png | Bin 0 -> 171243 bytes
assets/img/docs/docs-gtk-macos.png | Bin 0 -> 177442 bytes
assets/img/docs/docs-gtk-windows.png | Bin 0 -> 157859 bytes
...oc-hello-world-c.png => docs-hello-world-c.png} | Bin
...{doc-mono-develop.png => docs-mono-develop.png} | Bin
.../img/docs/{doc-search.png => docs-search.png} | Bin
assets/img/logo-gtk.png | Bin 4503 -> 68603 bytes
collections/_docs/architecture.md | 2 +-
collections/_docs/eclipse.md | 2 +-
collections/_docs/gnome-builder.md | 2 +-
collections/_docs/hello-world.md | 2 +-
collections/_docs/installations.md | 32 +++++++++++++-
collections/_docs/linux.md | 5 +--
collections/_docs/macos.md | 49 +++++++++++++++++++++
collections/_docs/mono-develop.md | 2 +-
collections/_docs/windows.md | 14 +++---
index.html | 6 +--
22 files changed, 101 insertions(+), 23 deletions(-)
---
diff --git a/_includes/header.html b/_includes/header.html
index 797f497..dfb5798 100644
--- a/_includes/header.html
+++ b/_includes/header.html
@@ -15,8 +15,8 @@
<meta name="author" content="The GTK Team">
<meta name="description" content="GTK is a highly usable, feature rich toolkit for creating graphical
user interfaces which boasts cross platform compatibility and an easy to use API. GTK is licensed under the
GNU LGPL 2.1 allowing development of both free and proprietary software with GTK without any license fees or
royalties.">
<meta name="keywords" content="gtk, gtk, gimp, gnome, toolkit, user interface">
- <link rel="icon" href="{{ '/assets/img/favicon-gtk.png' | prepend: site.url }}" type="image/x-icon">
- <link rel="shortcut icon" href="{{ '/assets/img/favicon-gtk.png' | prepend: site.url }}"
type="image/x-icon">
+ <link rel="icon" href="{{ '/assets/img/favicon-gtk.ico' | prepend: site.url }}" type="image/x-icon">
+ <link rel="shortcut icon" href="{{ '/assets/img/favicon-gtk.ico' | prepend: site.url }}"
type="image/x-icon">
<title>{{site.title}}</title>
<link rel="stylesheet" href="{{ '/assets/@fortawesome/fontawesome-free/css/all.min.css' | prepend:
site.url }}" type="text/css" media="screen" />
<link rel="stylesheet" href="{{ '/assets/css/markdown.css' | prepend: site.url }}" type="text/css"
media="screen" />
@@ -39,7 +39,7 @@
{% endif %}
<header class="navbar small bg-{{ bg_color }}">
<nav class="container navbar-expand-md px-0 px-md-3">
- <a href="{{ site.url }}" class="navbar-brand text-{{ text_color }}"><img src="{{
'/assets/img/logo-gtk.png' | prepend: site.url }}" width="40" height="40" /><strong>GTK</strong></a>
+ <a href="{{ site.url }}" class="navbar-brand text-{{ text_color }}"><img src="{{
'/assets/img/logo-gtk.png' | prepend: site.url }}" class="pr-2" style="width:40px;" /><strong>GTK</strong></a>
<a class="btn navbar-toggler border-0 p-0" role="button" data-toggle="collapse"
data-target="#navbarSupportedContent">
<i class="fas fa-ellipsis-h text-{{ text_color }}"></i>
</a>
@@ -66,7 +66,7 @@
<script>
var btnTop = $("#btn-go-to-top");
$(window).scroll(function() {
- if ($(window).scrollTop() < 300) {
+ if ($(window).scrollTop() < 400) {
btnTop.addClass("d-none");
}
else {
diff --git a/assets/img/docs/doc-builder.png b/assets/img/docs/docs-builder.png
similarity index 100%
rename from assets/img/docs/doc-builder.png
rename to assets/img/docs/docs-builder.png
diff --git a/assets/img/docs/doc-eclipse.png b/assets/img/docs/docs-eclipse.png
similarity index 100%
rename from assets/img/docs/doc-eclipse.png
rename to assets/img/docs/docs-eclipse.png
diff --git a/assets/img/docs/doc-gtk-architecture.png b/assets/img/docs/docs-gtk-architecture.png
similarity index 100%
rename from assets/img/docs/doc-gtk-architecture.png
rename to assets/img/docs/docs-gtk-architecture.png
diff --git a/assets/img/docs/docs-gtk-linux.png b/assets/img/docs/docs-gtk-linux.png
new file mode 100644
index 0000000..999c66a
Binary files /dev/null and b/assets/img/docs/docs-gtk-linux.png differ
diff --git a/assets/img/docs/docs-gtk-macos.png b/assets/img/docs/docs-gtk-macos.png
new file mode 100644
index 0000000..90c9acc
Binary files /dev/null and b/assets/img/docs/docs-gtk-macos.png differ
diff --git a/assets/img/docs/docs-gtk-windows.png b/assets/img/docs/docs-gtk-windows.png
new file mode 100644
index 0000000..afb5ad1
Binary files /dev/null and b/assets/img/docs/docs-gtk-windows.png differ
diff --git a/assets/img/docs/doc-hello-world-c.png b/assets/img/docs/docs-hello-world-c.png
similarity index 100%
rename from assets/img/docs/doc-hello-world-c.png
rename to assets/img/docs/docs-hello-world-c.png
diff --git a/assets/img/docs/doc-mono-develop.png b/assets/img/docs/docs-mono-develop.png
similarity index 100%
rename from assets/img/docs/doc-mono-develop.png
rename to assets/img/docs/docs-mono-develop.png
diff --git a/assets/img/docs/doc-search.png b/assets/img/docs/docs-search.png
similarity index 100%
rename from assets/img/docs/doc-search.png
rename to assets/img/docs/docs-search.png
diff --git a/assets/img/logo-gtk.png b/assets/img/logo-gtk.png
index 60ff46f..c45272f 100644
Binary files a/assets/img/logo-gtk.png and b/assets/img/logo-gtk.png differ
diff --git a/collections/_docs/architecture.md b/collections/_docs/architecture.md
index 287e705..0aa7c90 100644
--- a/collections/_docs/architecture.md
+++ b/collections/_docs/architecture.md
@@ -3,7 +3,7 @@ permalink: /docs/:name/
---
# Overview of GTK and its Libraries
-
+
Over time GTK has been built up to be based on four libraries, also developed by the GTK team.
diff --git a/collections/_docs/eclipse.md b/collections/_docs/eclipse.md
index ea6c292..a017a1f 100644
--- a/collections/_docs/eclipse.md
+++ b/collections/_docs/eclipse.md
@@ -3,7 +3,7 @@ permalink: /docs/dev-tools/:name/
---
# Eclipse
-
+
Eclipse is famous for our Java Integrated Development Environment (IDE), but our C/C++ IDE and PHP IDE are
pretty cool too. You can easily combine language support and other features into any of our default packages,
and the Eclipse Marketplace allows for virtually unlimited customization and extension.
diff --git a/collections/_docs/gnome-builder.md b/collections/_docs/gnome-builder.md
index 677ceca..84c5043 100644
--- a/collections/_docs/gnome-builder.md
+++ b/collections/_docs/gnome-builder.md
@@ -3,7 +3,7 @@ permalink: /docs/dev-tools/:name/
---
# GNOME Builder
-
+
GNOME Builder is a toolsmith for GNOME-based applications. It is a tool to help you write and contribute to
great GNOME-based applications.
diff --git a/collections/_docs/hello-world.md b/collections/_docs/hello-world.md
index ae87d52..0ffc17e 100644
--- a/collections/_docs/hello-world.md
+++ b/collections/_docs/hello-world.md
@@ -13,7 +13,7 @@ Below are some examples to get you started with GTK programming.
## Hello World App in C
-
+
To begin our introduction to GTK, we'll start with a simple `Hello World` GTK application.
diff --git a/collections/_docs/installations.md b/collections/_docs/installations.md
index 197362d..6bae16e 100644
--- a/collections/_docs/installations.md
+++ b/collections/_docs/installations.md
@@ -1,4 +1,34 @@
---
permalink: /docs/:name/
---
-installations
\ No newline at end of file
+# Installations
+
+GTK is available on:
+
+* [GNU/Linux and Unix](/docs/installations/linux/)
+* [Windows](/docs/installations/windows/)
+* [Mac OS X](/docs/installations/macos/)
+
+## Unstable releases
+
+The latest unstable tarballs can be downloaded from
[download.gnome.org](http://download.gnome.org/sources/gtk+/).
+
+## Bleeding edge
+
+Alternatively, you can check out the latest unstable release of GTK using git.
+
+```
+git clone https://gitlab.gnome.org/GNOME/gtk.git
+```
+
+If you plan on pushing changes back upstream and have a GNOME account, use the following instead:
+
+```
+git clone git gitlab gnome org:GNOME/gtk.git
+```
+
+For more information on this, see the instructions on [how to use the
repository](https://wiki.gnome.org/GitLab).
+
+## Repository Browser
+
+You can also download the dependencies from their git repository from your web browser for
[gtk](https://gitlab.gnome.org/GNOME/gtk), [glib](https://git.gnome.org/browse/glib),
[pango](https://git.gnome.org/browse/pango), [gdk-pixbuf](https://git.gnome.org/browse/gdk-pixbuf) and
[atk](https://git.gnome.org/browse/atk).
\ No newline at end of file
diff --git a/collections/_docs/linux.md b/collections/_docs/linux.md
index cf98f7b..af304e3 100644
--- a/collections/_docs/linux.md
+++ b/collections/_docs/linux.md
@@ -1,10 +1,9 @@
---
permalink: /docs/installations/:name/
---
+# Setting up GTK for GNU/Linux and Unix
-# Installing GTK for GNU/Linux and Unix
-
-## Stable Release
+
In order to install GTK for GNU/Linux and Unix systems, you will need to get the GLib,
GObject-Introspection, Pango, Gdk-Pixbuf, ATK and GTK packages to build GTK. To read more about these
packages, please refer to the [Architecture](/docs/architecture/).
diff --git a/collections/_docs/macos.md b/collections/_docs/macos.md
new file mode 100644
index 0000000..34857f8
--- /dev/null
+++ b/collections/_docs/macos.md
@@ -0,0 +1,49 @@
+---
+permalink: /docs/installations/:name/
+---
+# Setting up GTK for Mac OS
+
+
+
+## About
+
+Do you have a favorite GTK application that you'd like to run on your Mac with a more Mac-like look and
feel, with the menus up on the menu bar and standard Mac keyboard shortcuts like Command-Q? Perhaps you
maintain a GTK application and want to expand your user base to Mac users who want a Mac experience, not a
transplanted Unix experience?
+
+## Features
+
+Linking with GTK's [Quartz backend](https://wiki.gnome.org/Projects/GTK/OSX) connects your application to
the Mac's native display manager, keyboard, and pointing device. With a little extra code and
[gtk-mac-integration](https://wiki.gnome.org/Projects/GTK/OSX/Integration) you can:
+
+Integrate the Application's menus with the Mac Menubar
+Manipulate your application's dock tile
+Receive open events from Finder
+Find resources in your application bundle
+
+## Requirements
+
+There are a number of requirements that need to be met by your system before you can build for OSX. These
are updated from time to time and kept on the live wiki.
+
+## Building
+
+[Building](https://wiki.gnome.org/Projects/GTK/OSX/Building) with
[jhbuild](https://wiki.gnome.org/Projects/Jhbuild) and the GTK-OSX modulesets, you can build your application
and all of its dependent libraries with a single command.
+
+## All-in-one bundles
+
+[Bundling](https://wiki.gnome.org/Projects/GTK/OSX/Bundling) with the gtk-mac-bundler, an easily configured
python program which creates an application bundle for you and populates it with your application executable
and all of the dependent libraries from your GTK build, changing the installed names as needed to point
inside the bundle.
+
+## Getting Started
+
+First, make sure that your system meets the requirements as mentioned above, then download and run the
[installation script](http://git.gnome.org/browse/gtk-osx/plain/gtk-osx-build-setup.sh)
(gtk-osx-build-setup.sh). If your application already has a module, everything you need to build your
application is handled by jhbuild. The build page has detailed instructions.
+
+## Success Stories
+
+Some of the projects which have used GTK on Mac OS X have shared their
[experiences](https://wiki.gnome.org/Projects/GTK/OSX/PortedApps) for all to see. If you have any feedback
you would like to give about your experiences here, please contact us on the the users mailing list as
mentioned below.
+
+## Mailing lists & web forum
+
+Support for building, bundling, and the integration library is provided by a [mailing
list](http://mail.gnome.org/mailman/listinfo/gtk-osx-users-list) and a
[forum](http://sourceforge.net/apps/phpbb/gtk-osx/). Contributers may wish to subscribe to the [developer's
mailing list](http://mail.gnome.org/mailman/listinfo/gtk-osx-devel-list) as well.
+
+## Contributing
+
+Bugs, patches and enhancements for building, integration, or bundling may be submitted to [Bugzilla, with
Product=gtk-mac-integration](https://bugzilla.gnome.org/enter_bug.cgi?product=gtk-mac-integration). Bug
reports on any other package, including GTK itself, should be submitted against that package, not
gtk-mac-integration; the GTK component for the Quartz backend is "Backend: Quartz".
+
+***
\ No newline at end of file
diff --git a/collections/_docs/mono-develop.md b/collections/_docs/mono-develop.md
index 878b065..feaccb7 100644
--- a/collections/_docs/mono-develop.md
+++ b/collections/_docs/mono-develop.md
@@ -3,7 +3,7 @@ permalink: /docs/dev-tools/:name/
---
# Mono Develop
-
+
MonoDevelop enables developers to quickly write desktop and web applications on Linux, Windows and macOS. It
also makes it easy for developers to port .NET applications created with Visual Studio to Linux and macOS
maintaining a single code base for all platforms.
diff --git a/collections/_docs/windows.md b/collections/_docs/windows.md
index 32d22ea..2459bf1 100644
--- a/collections/_docs/windows.md
+++ b/collections/_docs/windows.md
@@ -1,18 +1,17 @@
---
permalink: /docs/installations/:name/
---
-
# Setting up GTK for Windows
-
+
Note: These instructions are intended for developers wanting to create Windows applications based on GTK,
not for end-users. On Windows, GTK applications are typically bundled with GTK already, so end-users do
not need to worry about how to install GTK itself.
There are two methods to install GTK on Windows development machines.
-* ### First Method
+* ### [First Method](#using-gtk-from-vcpkg-packages)
This method is based on the packages available from the [Microsoft vcpkg
project](https://docs.microsoft.com/en-us/cpp/vcpkg), which are built using Visual Studio, and therefore work
well if you intend to develop using that platform.
-* ### Second Method
+* ### [Second Method](#using-gtk-from-msys2-packages)
This method is based on the packages provided by [MSYS2](https://www.msys2.org/), which provides a
UNIX-like environment for Windows. Both of these repositories also provide packages for a large number of
other useful open source libraries.
If you really want to build GTK from the pristine sources yourself, you can use the project files for
Microsoft Visual Studio provided by the GTK releases. Learn more on [how to build the GTK stack using
Microsoft Visual Studio](https://wiki.gnome.org/Projects/GTK/Win32/MSVCCompilationOfGTKStack) and read these
other tips on [how to build GTK with MSVC on
Windows](https://blogs.gnome.org/nacho/2015/02/19/building-gtk-3-with-msvc-2013/). In almost all cases, using
the packages from `vcpkg` or `MSYS2` is much simpler though.
@@ -78,7 +77,6 @@ The [MSYS2](https://msys2.github.io/) project provides a UNIX-like development e
In MSYS2 packages are installed using the [pacman package
manager](https://github.com/msys2/msys2/wiki/MSYS2-installation#iv-general-package-management).
-
Note: in the following steps, we will assume you're using a `64-bit Windows`. Therefore, the package names
include the x86_64 architecture identifier. If you're using a 32-bit Windows, please adapt the
instructions below using the i686 architecture identifier.
**Step 1.**: Download the [MSYS2 installer](https://www.msys2.org/) that matches your platform and follow
the installation instructions.
@@ -124,8 +122,10 @@ pacman -S mingw-w64-x86_64-toolchain base-devel
You may use MSYS2 to [build your GTK application and create an installer to distribute
it](https://blogs.gnome.org/nacho/2014/08/01/how-to-build-your-gtk-application-on-windows/). Your installer
will need to ship your application build artifacts as well as GTK binaries and runtime dependencies; see the
instructions above for vcpkg for more details.
-### Legal notes on distributing GTK with your application
+## Legal notes on distributing GTK with your application
You are welcome to redistribute GTK binaries, including applications that bundle them, on other web sites,
CD-ROM, and other media. You don't have to ask for permission. That's one of the points of Free Software.
-One important thing that the [GNU licenses](http://www.fsf.org/licenses/licenses.html) require is that you
must also redistribute the source code. This usually means at least the gettext, GLib, GTK, Pango and ATK
sources.
\ No newline at end of file
+One important thing that the [GNU licenses](http://www.fsf.org/licenses/licenses.html) require is that you
must also redistribute the source code. This usually means at least the gettext, GLib, GTK, Pango and ATK
sources.
+
+***
\ No newline at end of file
diff --git a/index.html b/index.html
index 6126b39..cb00205 100644
--- a/index.html
+++ b/index.html
@@ -84,9 +84,9 @@ news_and_events_list:
<div class="dropdown">
<a class="btn btn-md btn-outline-secondary dropdown-toggle ml-2" href="#" role="button"
id="dropdownMenuLink" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Downloads</a>
<div class="dropdown-menu" aria-labelledby="dropdownMenuLink">
- <a href="{{ '/downloads/linux/' | prepend: site.url }}" class="dropdown-item"><i class="fab
fa-linux"></i> Linux</a>
- <a href="{{ '/downloads/windows/' | prepend: site.url }}" class="dropdown-item"><i class="fab
fa-windows"></i> Windows</a>
- <a href="{{ '/downloads/macos/' | prepend: site.url }}" class="dropdown-item"><i class="fab
fa-apple"></i> MacOS</a>
+ <a href="{{ '/downloads/linux/' | prepend: site.url }}" class="dropdown-item"><i class="fab
fa-linux pr-2 fa-fw"></i>Linux</a>
+ <a href="{{ '/downloads/windows/' | prepend: site.url }}" class="dropdown-item"><i class="fab
fa-windows pr-2 fa-fw"></i>Windows</a>
+ <a href="{{ '/downloads/macos/' | prepend: site.url }}" class="dropdown-item"><i class="fab
fa-apple pr-2 fa-fw"></i>MacOS</a>
</div>
</div>
</div>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
