New structure headings

Also adds a note to readme for installing pdflatex if it's missing.

README.md

@@ -602,10 +602,12 @@ Simply visit https://yosys.readthedocs.io/en/latest/ instead.
 In addition to those packages listed above for building Yosys from source, the
 following are used for building the website: 
 
-	$ sudo apt-get install pdf2svg faketime
+	$ sudo apt install pdf2svg faketime
 
 PDFLaTeX, included with most LaTeX distributions, is also needed during the
-build process for the website.
+build process for the website.  Or, run the following:
+
+	$ sudo apt install texlive-latex-base texlive-latex-extra
 
 The Python package, Sphinx, is needed along with those listed in
 `docs/source/requirements.txt`:

docs/source/conf.py

@@ -43,6 +43,7 @@ bibtex_bibfiles = ['literature.bib']
 exclude_patterns = [
 	"CHAPTER_Eval.rst",
 	"appendix/CHAPTER_StateOfTheArt.rst"
+	"test_suites.rst"
 ]
 
 latex_elements = {

docs/source/getting_started.rst

@@ -0,0 +1,14 @@
+Getting started with Yosys
+==========================
+
+Installation
+------------
+
+Supported platforms
+~~~~~~~~~~~~~~~~~~~
+
+Introduction to scripting in Yosys
+----------------------------------
+
+Example(s)
+----------

docs/source/index.rst

@@ -27,6 +27,15 @@
 Yosys manual
 ================================================================================
 
+.. toctree::
+	:caption: New docs
+	
+	introduction
+	getting_started
+	using_yosys
+	yosys_internals
+..	test_suites
+
 .. toctree::
 	:maxdepth: 2
 	:caption: Manual

docs/source/introduction.rst

@@ -0,0 +1,8 @@
+What is Yosys
+=============
+
+What you can do with Yosys
+--------------------------
+
+The extended Yosys universe
+---------------------------

docs/source/test_suites.rst

@@ -0,0 +1,8 @@
+Test suites
+===========
+
+Build tests
+-----------
+
+Benchmarking
+------------

docs/source/using_yosys.rst

@@ -0,0 +1,25 @@
+Using Yosys (advanced)
+======================
+
+More scripting
+--------------
+
+Selections
+~~~~~~~~~~
+
+Note on show/viz
+
+Troubleshooting
+~~~~~~~~~~~~~~~
+
+Memory map patterns
+-------------------
+
+Flows, command types, and order
+-------------------------------
+
+Synthesis granularity
+~~~~~~~~~~~~~~~~~~~~~
+
+Formal verification
+~~~~~~~~~~~~~~~~~~~

docs/source/yosys_internals.rst

@@ -0,0 +1,23 @@
+Yosys internals
+===============
+
+Control and data flow
+---------------------
+
+Frontends
+~~~~~~~~~
+
+Backends
+~~~~~~~~
+
+Passes
+~~~~~~
+
+RTLIL
+-----
+
+Techmap
+-------
+
+Writing extensions
+------------------