Simplified documentation generation

- README.md is now copied to src/index.md (same content)
- add docs/src/index.md to .gitignore
- export jacobian function

.gitignore

@@ -2,3 +2,4 @@ docs/build/
 docs/site/
 *.cov
 *.swp
+docs/src/index.md

README.md

@@ -1,11 +1,10 @@
-# FEMBasis.jl
-
 [![Build Status](https://travis-ci.org/JuliaFEM/FEMBasis.jl.svg?branch=master)](https://travis-ci.org/JuliaFEM/FEMBasis.jl)[![Coverage Status](https://coveralls.io/repos/github/JuliaFEM/FEMBasis.jl/badge.svg?branch=master)](https://coveralls.io/github/JuliaFEM/FEMBasis.jl?branch=master)[![](https://img.shields.io/badge/docs-stable-blue.svg)](https://juliafem.github.io/FEMBasis.jl/stable)[![](https://img.shields.io/badge/docs-latest-blue.svg)](https://juliafem.github.io/FEMBasis.jl/latest)[![Issues](https://img.shields.io/github/issues/JuliaFEM/FEMBasis.jl.svg)](https://github.com/JuliaFEM/FEMBasis.jl/issues)
 
-Package contains interpolation routines for standard finite element function spaces. 
-Given ansatz and coordinates of domain, interpolation functions are calculated 
-symbolically in a very general way to get efficient code. As a concrete example, 
-to evaluate basis functions for standard tetrahedron we write
+`FEMBasis.jl` contains interpolation routines for standard finite element
+function spaces.  Given ansatz and coordinates of domain, interpolation
+functions are calculated  symbolically in a very general way to get efficient
+code. As a concrete example, to generate basis functions for a standard 10-node
+tetrahedron one can write
 
 ```julia
 code = create_basis(

docs/make.jl

@@ -3,11 +3,13 @@
 
 using Documenter, FEMBasis
 
+cp("../README.md", "src/index.md"; remove_destination=true)
+
 makedocs(modules=[FEMBasis],
          format = :html,
-         sitename = "FEMBasis",
+         checkdocs = :all,
+         sitename = "FEMBasis.jl",
          pages = [
                   "Introduction" => "index.md",
-                  "Theory" => "theory.md",
-                  "API" => "api.md",
+                  "API documentation" => "api.md",
                  ])

docs/src/api.md

@@ -1,14 +1,9 @@
-# API documentation
-
-## Index
-
 ```@index
 ```
 
 ```@meta
 DocTestSetup = quote
     using FEMBasis
-    using FEMBasis: jacobian
 end
 ```
 

src/FEMBasis.jl

@@ -33,7 +33,7 @@ include("nurbs_solid.jl")
 export NSolid
 
 include("math.jl")
-export interpolate, interpolate!
+export interpolate, interpolate!, jacobian
 export grad, grad!
 export BasisInfo