output entities to html; update README