diff --git a/pages/docs.txt b/pages/docs.txt old mode 100644 new mode 100755 index 470c18a61..8930a884e --- a/pages/docs.txt +++ b/pages/docs.txt @@ -2,7 +2,17 @@ {{page>start-shortcuts}} -==== Getting into Development ==== +==== Enlightenment and EFL Developer Documentation ==== + +Enlightenment has developed from a window manager into a set of libraries +that support a large number of exciting applications. +Aimed primarily at slick graphical presentation and optimal runtime we +created the Enlightenment Foundation Libraries and have created the following +documentation to help everyone get involved - thanks for stopping by. + + + +====Getting Started==== If you are going to use EFL, we encourage you to actually work with EFL from [[http://git.enlightenment.org|git]] mostly because it allows @@ -26,49 +36,70 @@ course you can use stable packages for your distribution as well. Go check the current available version of EFL on each distro/platform: [[https://phab.enlightenment.org/w/packaging_status/|Table of current version of EFL]] +=== Working with Code === + + * [[docs/c/start|A basic primer on C]] + + + + +====EFL Documentation==== + +The EFL is currently undergoing a significant redesign to give a better +developer experience when building apps using our platform. +For now we recommend using the stable API and it's Bindings. + +=== Working with EFL === + + * [[docs/efl/start|Get started with EFL]] + * [[docs/efl/advanced/start|Advanced EFL Topics]] + +=== Stable API === + + * [[http://docs.enlightenment.org/efl/current|C (our main language)]] + * [[http://docs.enlightenment.org/python-efl/current|Python Bindings]] + +=== Beta API using EO === + + * [[docs/efl/auto/reference|EFL EO API documentation (C)]] + + + + +====Contributing==== + +We are really excited that you would like to get involved in EFL and +Enlightenment development! If you followed the instructions in +"Getting Started" then you are most of the way to being part of the team. +To start with it's easiest to see which area you would like to work on and +get involved in bug reporting or fixing. From there you can get to know the +team, how we work, and earn a place on the team as a core developer :) + === Feedback === * [[debugging/report_bugs|Report bugs on Phabricator]] * [[contact/arcanist|Submit patch on Phabricator]] -=== Working with EFL and Code === - - * [[docs/c/start|A basic primer on C]] - * [[docs/efl/start|Get started with EFL]] - * [[docs-efl-debug|Debugging (generic) - EFL and Enlightenment]] - * [[docs/efl/advanced/start|Advanced EFL Topics]] - -=== Themes / Edje / EDC === - -A core part of Enlightenment and EFL is the design/theme abstraction layer. This is handled by the Edje library and a series of tools that can compile/package up theme files and compress them, decompile them, and even provide some GUI editors too. - - * [[about-eflete|Eflete]] - GUI Theme design tool - * [[about-enventor|Enventor]] GUI Edje file design tool - * [[themes/start|Getting started]] with Edje and themes at the EDC file level - * [[themes/knob_example|Edje theme example]] A knob theme for the Elementary slider widget - === Debugging === + * [[docs-efl-debug|Debugging (generic) - EFL and Enlightenment]] * [[debugging/enlightenment_debugging|Enlightenment specific debugging]] * [[debugging/apps_efl_debugging|EFL application debugging]] * [[debugging/remote_debugging|Remote Debugging]] -=== Tutorials === - * [[tutorial/basic_tutorial|Basic Tutorial]] - * [[tutorial/genlist_tutorial|Genlist Tutorial]] - * [[tutorial/panes_tutorial|Panes Tutorial]] - * [[tutorial/form_tutorial|Form Tutorial]] - * [[tutorial/menu_tutorial|Menu Tutorial]] - * [[tutorial/naviframe_tutorial|Naviframe Tutorial]] - * [[tutorial/popup_tutorial|Popup Tutorial]] - * [[tutorial/gl_2d_tutorial|GL 2D Tutorial]] - * [[tutorial/preference_tutorial|Preference Tutorial]] - * [[tutorial/effects_tutorial|Effects Tutorial]] - * [[tutorial/multimedia_tutorial|Multimedia Tutorial]] - * [[tutorial/javascript_tutorial|JavaScript Tutorial]] + -=== Programming Guide === +That's it for the basics - hopefully you are now up and running with +the EFL (and perhaps Enlightenment too!) and looking to learn more. +Here is a collection of guides and tutorials to help you get deeper into +working with our libraries and building great apps. + +Be sure to [[contact]] to show what youve built! + + + +==== Programming Guide ==== * [[program_guide/basic_application_structure_pg|Basic Application structure]] * [[program_guide/eina_pg|Eina]] @@ -86,23 +117,38 @@ A core part of Enlightenment and EFL is the design/theme abstraction layer. This * [[program_guide/multilingual_pg|Multilingual]] * [[program_guide/evasgl_pg|Evas GL]] + + +==== Tutorials ==== + + * [[tutorial/basic_tutorial|Basic Tutorial]] + * [[tutorial/genlist_tutorial|Genlist Tutorial]] + * [[tutorial/panes_tutorial|Panes Tutorial]] + * [[tutorial/form_tutorial|Form Tutorial]] + * [[tutorial/menu_tutorial|Menu Tutorial]] + * [[tutorial/naviframe_tutorial|Naviframe Tutorial]] + * [[tutorial/popup_tutorial|Popup Tutorial]] + * [[tutorial/gl_2d_tutorial|GL 2D Tutorial]] + * [[tutorial/preference_tutorial|Preference Tutorial]] + * [[tutorial/effects_tutorial|Effects Tutorial]] + * [[tutorial/multimedia_tutorial|Multimedia Tutorial]] + * [[tutorial/javascript_tutorial|JavaScript Tutorial]] + === Samples === * [[samples/elm_min_size_control|Controlling Minimum Size of Widgets]] ----- -==== API Documentation ==== + -Our documentation is a bit scarce at the moment, but that is something -we intend to solve. We will collect all documentation here and work on -improving our API references a lot. +==== Themes / Edje / EDC ==== -=== Last Release === +A core part of Enlightenment and EFL is the design/theme abstraction layer. This is handled by the Edje library and a series of tools that can compile/package up theme files and compress them, decompile them, and even provide some GUI editors too. - * [[http://docs.enlightenment.org/efl/current|EFL]] - * [[http://docs.enlightenment.org/python-efl/current|Python Bindings]] + * [[about-eflete|Eflete]] - GUI Theme design tool + * [[about-enventor|Enventor]] GUI Edje file design tool + * [[themes/start|Getting started]] with Edje and themes at the EDC file level + * [[themes/knob_example|Edje theme example]] A knob theme for the Elementary slider widget -=== Our upcoming EO based API documentation === + - * [[docs/efl/auto/reference|EFL EO API documentation]]