From 3dfacc01ab9ca6c8a7c0b762b694a0a45da6fa3b Mon Sep 17 00:00:00 2001 From: Dave Andreoli Date: Sun, 14 Nov 2021 23:24:18 +0100 Subject: [PATCH] Docs: added infra for tutorials Also remove some really old presentation text, we should write some new intro --- doc/index.rst | 39 ++++++++-------------------------- doc/tutorials/01-window.rst | 21 ++++++++++++++++++ doc/tutorials/02-sizehints.rst | 21 ++++++++++++++++++ 3 files changed, 51 insertions(+), 30 deletions(-) create mode 100644 doc/tutorials/01-window.rst create mode 100644 doc/tutorials/02-sizehints.rst diff --git a/doc/index.rst b/doc/index.rst index 206894f..2708944 100644 --- a/doc/index.rst +++ b/doc/index.rst @@ -1,36 +1,7 @@ -Python Bindings for Enlightenment Foundation Libraries' documentation +Python-EFL ##################################################################### -EFL is a collection of libraries that are independent or may build on top of -each-other to provide useful features that complement an OS's existing -environment, rather than wrap and abstract it, trying to be their own -environment and OS in its entirety. This means that it expects you to use -other system libraries and API's in conjunction with EFL libraries, to provide -a whole working application or library, simply using EFL as a set of -convenient pre-made libraries to accomplish a whole host of complex -or painful tasks for you. - -One thing that has been important to EFL is efficiency. That is in both -speed and size. The core EFL libraries even with Elementary are about half -the size of the equivalent "small stack" of GTK+ that things like GNOME -use. It is in the realm of one quarter the size of Qt. Of course these -are numbers that can be argued over as to what constitutes an equivalent -measurement. EFL is low on actual memory usage at runtime with memory -footprints a fraction the size of those in the GTK+ and Qt worlds. In -addition EFL is fast. For what it does. Some libraries claim to be very -fast - but then they also don't "do much". It's easy to be fast when you -don't tackle the more complex rendering problems involving alpha blending, -interpolated scaling and transforms with dithering etc. EFL tackles these, -and more. - -.. seealso:: - - - `EFL Overview `_ - - `EFL Documentation `_ - - `EDC Reference `_ - - `EFL Big Picture `_ - EFL === @@ -92,6 +63,14 @@ DBus integration .. toctree:: dbus/dbus +Tutorials +========= + +.. toctree:: + tutorials/01-window.rst + tutorials/02-sizehints.rst + + Acknowledgements ================ diff --git a/doc/tutorials/01-window.rst b/doc/tutorials/01-window.rst new file mode 100644 index 0000000..def5ae5 --- /dev/null +++ b/doc/tutorials/01-window.rst @@ -0,0 +1,21 @@ + +Tutorial 1 - Window +=================== + +Lorem ipsum dolor sit amet, consectetur adipiscing elit. Praesent mattis id dui +vitae lobortis. Fusce et tempus ipsum. Nulla non luctus urna. Pellentesque et +luctus diam. Etiam fermentum vestibulum nisi, eget vestibulum turpis aliquet vitae. +Integer interdum enim eu lacus pulvinar malesuada. Ut urna mi, congue non +pellentesque id, varius eget diam. Ut placerat neque sed orci tincidunt consequat. +Cras fermentum fringilla pulvinar. Ut tempor turpis odio. + +Vivamus sed magna tempor orci pharetra dapibus. Phasellus est elit, rhoncus +vitae consequat id, semper at ligula. Sed vitae odio tempor, maximus mi placerat, +faucibus metus. Quisque eget mauris quis ex gravida iaculis finibus vitae arcu. +Morbi non porttitor velit. Nullam pretium ex neque, ac malesuada felis dapibus +sodales. Pellentesque tristique est vel accumsan lobortis. Curabitur viverra +diam sit amet odio tincidunt pellentesque. Vestibulum non eros orci. Aliquam +accumsan convallis ullamcorper. Donec tristique massa nec massa venenatis tempus. +Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos +himenaeos. Aliquam augue nibh, viverra at urna in, lacinia maximus leo. +Nullam vestibulum lobortis elementum. \ No newline at end of file diff --git a/doc/tutorials/02-sizehints.rst b/doc/tutorials/02-sizehints.rst new file mode 100644 index 0000000..dec5ba7 --- /dev/null +++ b/doc/tutorials/02-sizehints.rst @@ -0,0 +1,21 @@ + +Tutorial 2 - Size Hints +======================= + +Lorem ipsum dolor sit amet, consectetur adipiscing elit. Praesent mattis id dui +vitae lobortis. Fusce et tempus ipsum. Nulla non luctus urna. Pellentesque et +luctus diam. Etiam fermentum vestibulum nisi, eget vestibulum turpis aliquet vitae. +Integer interdum enim eu lacus pulvinar malesuada. Ut urna mi, congue non +pellentesque id, varius eget diam. Ut placerat neque sed orci tincidunt consequat. +Cras fermentum fringilla pulvinar. Ut tempor turpis odio. + +Vivamus sed magna tempor orci pharetra dapibus. Phasellus est elit, rhoncus +vitae consequat id, semper at ligula. Sed vitae odio tempor, maximus mi placerat, +faucibus metus. Quisque eget mauris quis ex gravida iaculis finibus vitae arcu. +Morbi non porttitor velit. Nullam pretium ex neque, ac malesuada felis dapibus +sodales. Pellentesque tristique est vel accumsan lobortis. Curabitur viverra +diam sit amet odio tincidunt pellentesque. Vestibulum non eros orci. Aliquam +accumsan convallis ullamcorper. Donec tristique massa nec massa venenatis tempus. +Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos +himenaeos. Aliquam augue nibh, viverra at urna in, lacinia maximus leo. +Nullam vestibulum lobortis elementum.