Added Tutorial drafts that as of now just outline topics yet to be written.

cztomczak · cztomczak · commit c0af649c0cdd · 2016-02-27T13:28:15.000+01:00
diff --git a/Tutorial-beginner.md b/Tutorial-beginner.md
@@ -0,0 +1,59 @@
+This is just a draft that outlines topics yet to be written.
+TODO: see the CEF Tutorial wiki
+
+# Tutorial
+
+
+## Download and install
+
+* download from Releases/
+* types of packages for each platform
+* install from PyPI using pip (Win/Mac)
+
+
+## Simple example using wxPython
+
+* paste code, most simple example loading www.google.com,
+  shouldn't be more than 20 lines.
+
+* Explain all functions from the example:
+    - initialize()
+        you can call initialize and shutdown only once
+    - shutdown()
+        - to exit cleanly
+        - cookies or other storage might not be saved (flushed every 30 secs)
+          process might freeze (XP experienced)
+    - messageloop
+    - messageloopwork
+        - messageloop faster, but this one allows integration into
+          existing message loop
+
+* ExceptHook in examples so that all processes are closed in
+  case of a python error
+
+* there are more examples in the examples/ directory.
+
+
+## Settings
+
+* Describe a few most commonly used settings.
+* Command-line switches from Chromium.
+* Disable developer-tools or context menu
+    - application settings context menu dict.
+
+
+## Documentation and help
+
+* see the api/ directory.
+    - API categories.md and API full index.md
+      will help you navigate through API.
+
+* knowledge base document
+
+* "Search this repository" to search through documentation and code
+
+* Try google "cef +search-phrase"
+
+* Forum - ask questions and report problems there, not in Issue Tracker
+
+* See Tutorial-intermediate.
diff --git a/Tutorial-intermediate.md b/Tutorial-intermediate.md
@@ -0,0 +1,52 @@
+This is just a draft that outlines topics yet to be written.
+TODO: see the CEF General Usage and Javascript Integration wikis.
+
+# Tutorial - intermediate
+
+* Read first Tutorial-beginner.
+
+
+## Architecture
+
+* subprocess.exe
+* browser process
+* renderer process
+* gpu process
+* zygote on linux
+* Describe browser process threads
+
+
+## Handlers
+
+* What are handlers.
+* Handler callbacks may be called either on UI thread or IO thread.
+  Use functions for posting tasks when need to access UI thread from IO thread.
+* Example code how to use handlers - use base code from Tutorial-beginner.
+    - keyboard handler F12 devtools and F5
+    - loadhandler onloadstart to insert js to all pages
+    - loadhandler onloadingstatechange when page completed loading
+    - onloaderror
+
+
+## Javascript integration
+
+* how to expose function to js
+* how to communicate two-way js<>python
+* callbacks
+* js errors handling
+* example code how to use - use base code from Tutorial-beginner.
+
+
+## Plugins
+
+* Load PPAPI flash plugin
+    - console window issue on Windows in CEF 47, possible solutions
+
+
+## Off-screen rendering
+
+* Describe difference between windowed rendering and off-screen rendering.
+* Panda3D and Kivy - offscreen
+* The rest - windowed
+* Describe render handler callbacks in kivy - how this works.
+
diff --git a/tools/README.md b/tools/README.md
@@ -11,13 +11,11 @@ pip install -r requirements.txt
 apidocs.py      - generate API docs from Cython sources
 automate.py     - download CEF binaries, build and optionally install/run
 build.py        - build the cefpython module
-doctoc.py       - generate table of contents for all .md in docs/
 make_distrib.py - make distribution packages (msi, wheel, deb pkg and more)
 run.py          - rebuild and install if changed, and run example(s)
-setpython.bat   - change python installation in PATH (Windows)
-setpython.sh    - change python installation in PATH (Linux and Mac)
 test_distrib.py - for all distribution packages install each of them
                   and run unit tests and all examples
+toc.py          - generate Table of contents for .md files
 translator.py   - generate code from the CEF header files
 unittests.py    - run unit tests
 ```
diff --git a/tools/toc.py b/tools/toc.py
@@ -5,6 +5,8 @@
 Usage:
     toc.py FILE
     toc.py DIR
+
+To ignore file when generating TOC, put an empty line just before H1.
 """
 
 import os
