DocumentationISO.cs

// Name:        DocumentationISO.cs
// Description: Generates documentation
// Author:      Tim Chipman
// Origination: Work performed for BuildingSmart by Constructivity.com LLC.
// Copyright:   (c) 2010 BuildingSmart International Ltd.
// License:     https://standards.buildingsmart.org/legal

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.IO;
using System.Text;
using System.Linq;
//using System.Xml.Serialization;

using BuildingSmart.IFC;
using BuildingSmart.IFC.IfcKernel;
using BuildingSmart.IFC.IfcMeasureResource;
using BuildingSmart.IFC.IfcUtilityResource;
using BuildingSmart.IFC.IfcRepresentationResource;

using IfcDoc.Schema;
using IfcDoc.Schema.DOC;
using IfcDoc.Schema.PSD;
using IfcDoc.Schema.MVD;
using IfcDoc.Format.EXP;
using IfcDoc.Format.CSC;
using IfcDoc.Format.JAV;
using IfcDoc.Format.HTM;
using IfcDoc.Format.XSD;
using IfcDoc.Format.XML;
using IfcDoc.Format.PNG;

using BuildingSmart.Serialization;
using BuildingSmart.Serialization.Json;
using BuildingSmart.Serialization.Step;
using BuildingSmart.Serialization.Turtle;
using BuildingSmart.Serialization.Xml;
using BuildingSmart.Utilities.Conversion;
using System.Net;

namespace IfcDoc
{
	public static class DocumentationISO
	{
		/// <summary>
		/// Capture link to table or figure
		/// </summary>
		public struct ContentRef
		{
			public string Caption; // caption to be displayed in table of contents
			public DocObject Page; // relative link to reference

			public ContentRef(string caption, DocObject page)
			{
				this.Caption = caption;
				this.Page = page;
			}
		}

		public static IfcProjectLibrary generatePropertyLibrary(DocProject docProject, Dictionary<DocObject, bool> included)
		{
			IfcProjectLibrary ifcProjectLibrary = new IfcProjectLibrary(new IfcGloballyUniqueId("2OqsW47Dz0LgTmf4DAn1f4"), null, new IfcLabel("IFC Templates"), null, null, null, null, new IfcRepresentationContext[] { }, null);
			Program.ExportIfc(ifcProjectLibrary, docProject, included);
			return ifcProjectLibrary;
		}
		/// <summary>
		/// Exports file.
		/// </summary>
		/// <param name="docProject">Required project.</param>
		/// <param name="docPublication">Optional publication for providing specific settings.</param>
		/// <param name="filepath">Required path to file to be exported.</param>
		/// <param name="views">Optional list of model views.</param>
		/// <param name="locales">Optional list of locales.</param>
		/// <param name="scope">Mask of definitions to export.</param>
		/// <param name="schemaNamespace">Optional version of export format; provided for mvdXML.</param>
		/// <param name="instances">Required map of instances.</param>
		/// <param name="mapEntity">Required map of definitions.</param>
		public static void DoExport(
			DocProject docProject, DocPublication docPublication, string filepath,
			DocModelView[] views, string[] locales,
			DocDefinitionScopeEnum scope,
			string schemaNamespace,
			Dictionary<string, DocObject> mapEntity)
		{
			string ext = System.IO.Path.GetExtension(filepath).ToLower();

			string xmlns = null;
			Dictionary<DocObject, bool> included = null;
			if (views != null)
			{
				included = new Dictionary<DocObject, bool>();
				foreach (DocModelView docView in views)
				{
					docProject.RegisterObjectsInScope(docView, included);
				}
				xmlns = views[0].XsdUri;
			}

			string schemacode = docProject.GetSchemaIdentifier();
			string schemauri = docProject.GetSchemaURI(null);

			// special case for zip files -- determine based on special naming; make configurable in future
			Type typeExport = null;
			if (filepath.EndsWith("-psd.zip_"))
			{
				typeExport = typeof(DocPropertySet);
			}
			else if (filepath.EndsWith("-qto.zip_"))
			{
				typeExport = typeof(DocQuantitySet);
			}

			switch (ext)
			{
				case ".ifc": // generate templates in ifc file for property sets and quantity sets
					using (FileStream stream = new FileStream(filepath, FileMode.Create))
					{
						// export property sets and quantity sets
						IfcProjectLibrary ifcProjectLibrary = generatePropertyLibrary(docProject, included);
						StepSerializer format = new StepSerializer(ifcProjectLibrary.GetType());
						format.WriteObject(stream, ifcProjectLibrary);
					}
					break;

				case ".ifcxml":
					using (FileStream stream = new FileStream(filepath, FileMode.Create))
					{
						// export property sets and quantity sets
						IfcProjectLibrary ifcProjectLibrary = generatePropertyLibrary(docProject, included);
						XmlHeader header = new XmlHeader();
						XmlElementIfc xmlElementIfc = new XmlElementIfc(header, ifcProjectLibrary);
						XmlSerializer format = new XmlSerializer(typeof(IfcProjectLibrary))
						{
							NameSpace = XmlElementIfc.NameSpace,
							SchemaLocation = XmlElementIfc.SchemaLocation
						};
						format.WriteObject(stream, xmlElementIfc);
					}
					break;

				case ".mvdxml":
					if (schemaNamespace == null)
					{
						schemaNamespace = mvdXML.NamespaceV11;
					}
					using (FormatXML format = new FormatXML(filepath, typeof(mvdXML), schemaNamespace))
					{
						mvdXML mvd = new mvdXML();
						if (schemaNamespace == mvdXML.NamespaceV12)
						{
							mvd.schemaLocation = mvdXML.LocationV12;
						}

						Program.ExportMvd(mvd, docProject, schemaNamespace, mapEntity, included);
						format.Instance = mvd;
						format.Save();
					}
					break;

				case ".cs":
					using (FormatCSC format = new FormatCSC(filepath))
					{
						format.Instance = docProject;
						format.Map = mapEntity;
						format.Save();
					}
					break;

				case ".exp":
					// use currently visible model view(s)
					using (FormatEXP format = new FormatEXP(docProject, null, views, filepath))
					{
						format.Save();
					}
					break;

				case ".xsd":
					// use currently visible model view(s)
					using (FormatXSD format = new FormatXSD(filepath))
					{
						format.Project = docProject;
						format.Publication = docPublication;
						format.ModelViews = views;
						format.Save();
					}
					break;

				case ".xml": // Express XSD Configuration
					using (FormatXML format = new FormatXML(filepath, typeof(Schema.CNF.configuration), null, Schema.CNF.SchemaCNF.Prefixes))
					{
						Schema.CNF.configuration config = new Schema.CNF.configuration();
						Program.ExportCnf(config, docProject, views, included);
						format.Instance = config;
						format.Save();
					}
					break;

				case ".txt":
					// pick locale
					using (FormatCSV format = new FormatCSV(filepath))
					{
						format.Instance = docProject;
						format.Locales = locales;
						format.Scope = scope;
						format.Save();
					}
					break;

				case ".sch":
					using (FormatXML format = new FormatXML(filepath, typeof(Schema.SCH.schema), "http://purl.oclc.org/dsdl/schematron"))
					{
						Schema.SCH.schema sch = new Schema.SCH.schema();
						Program.ExportSch(sch, docProject, included);
						format.Instance = sch;
						format.Save();
					}
					break;

				case ".zip":
				case ".zip_":
					using (FormatZIP format = new FormatZIP(new System.IO.FileStream(filepath, System.IO.FileMode.Create), docProject, included, typeExport))
					{
						format.Save();
					}
					break;
			}

		}


		/// <summary>
		/// Copies files and folders recursively, skipping those that already exist.
		/// </summary>
		/// <param name="sourcepath">Path of source directory</param>
		/// <param name="targetpath">Path of target directory</param>
		private static void CopyFiles(string sourcepath, string targetpath, bool overrideExisting = false)
		{
			if (!System.IO.Directory.Exists(sourcepath))
				return;

			string[] arrFiles = System.IO.Directory.GetFiles(sourcepath);
			foreach (string sourcefile in arrFiles)
			{
				string filename = System.IO.Path.GetFileName(sourcefile);
				string targetfile = System.IO.Path.Combine(targetpath, filename);

				try
				{
					if (overrideExisting == true)
						System.IO.File.Copy(sourcefile, targetfile, true);
					else
						if (!System.IO.File.Exists(targetfile))
						{
							System.IO.File.Copy(sourcefile, targetfile);
						}
				}
				catch
				{
				}
			}

			string[] arrDirectories = System.IO.Directory.GetDirectories(sourcepath);
			foreach (string sourcedir in arrDirectories)
			{
				string dirname = System.IO.Path.GetFileName(sourcedir);
				string targetdir = System.IO.Path.Combine(targetpath, dirname);

				try
				{
					if (!System.IO.Directory.Exists(targetdir))
					{
						System.IO.Directory.CreateDirectory(targetdir);
					}
				}
				catch
				{
				}

				CopyFiles(sourcedir, targetdir);
			}
		}

		/// <summary>
		/// Builds list of items in order, using inherited concepts.
		/// </summary>
		/// <param name="entity"></param>
		/// <param name="template"></param>
		/// <param name="view"></param>
		private static DocTemplateItem[] FindTemplateItems(DocProject docProject, DocEntity entity, DocTemplateDefinition template, DocModelView view, DocConceptRoot root = null)
		{
			// inherited concepts first

			List<DocTemplateItem> listItems = new List<DocTemplateItem>();
			DocEntity basetype = entity;
			bool inherit = true;
			while (basetype != null)
			{
				// find templates for base
				foreach (DocModelView docView in docProject.ModelViews)
				{
					if (view == docView || view.BaseView == docView.Name)
					{
						foreach (DocConceptRoot docRoot in docView.ConceptRoots)
						{
							if (docRoot.ApplicableEntity == basetype && root == null)
							{
								foreach (DocTemplateUsage eachusage in docRoot.Concepts)
								{
									if (eachusage.Definition == template)
									{
										// found it

										string[] parameters = template.GetParameterNames();

										foreach (DocTemplateItem eachitem in eachusage.Items)
										{
											string[] values = new string[parameters.Length];
											for (int iparam = 0; iparam < parameters.Length; iparam++)
											{
												values[iparam] = eachitem.GetParameterValue(parameters[iparam]);
											}

											// new (IfcDoc 4.9d): only add if we don't override by parameters matching exactly
											bool include = true;
											foreach (DocTemplateItem existitem in listItems)
											{
												bool samevalues = true;

												for (int iparam = 0; iparam < parameters.Length; iparam++)
												{
													string value = values[iparam];
													string match = existitem.GetParameterValue(parameters[iparam]);
													if (match != value || (match != null && !match.Equals(value, StringComparison.Ordinal)))
													{
														samevalues = false;
														break;
													}
												}

												if (samevalues)
												{
													include = false;
													break;
												}
											}

											if (include)
											{
												listItems.Add(eachitem);
											}
										}

										inherit = !eachusage.Override;
									}
								}
							}
							else if (docRoot.ApplicableEntity == basetype && root.Equals(docRoot))
							{
								foreach (DocTemplateUsage eachusage in docRoot.Concepts)
								{
									if (eachusage.Definition == template)
									{
										// found it

										string[] parameters = template.GetParameterNames();

										foreach (DocTemplateItem eachitem in eachusage.Items)
										{
											string[] values = new string[parameters.Length];
											for (int iparam = 0; iparam < parameters.Length; iparam++)
											{
												values[iparam] = eachitem.GetParameterValue(parameters[iparam]);
											}

											// new (IfcDoc 4.9d): only add if we don't override by parameters matching exactly
											bool include = true;
											foreach (DocTemplateItem existitem in listItems)
											{
												bool samevalues = true;

												for (int iparam = 0; iparam < parameters.Length; iparam++)
												{
													string value = values[iparam];
													string match = existitem.GetParameterValue(parameters[iparam]);
													if (match != value || (match != null && !match.Equals(value, StringComparison.Ordinal)))
													{
														samevalues = false;
														break;
													}
												}

												if (samevalues)
												{
													include = false;
													break;
												}
											}

											if (include)
											{
												listItems.Add(eachitem);
											}
										}

										inherit = !eachusage.Override;
									}
								}
							}
						}
					}
				}

				// inherit concepts from supertypes unless overriding
				if (basetype.BaseDefinition != null && inherit)
				{
					basetype = docProject.GetDefinition(basetype.BaseDefinition) as DocEntity;
				}
				else
				{
					basetype = null;
				}
			}

			return listItems.ToArray();
		}

		/// <summary>
		/// Formats table for single exchange
		/// </summary>
		/// <param name="def"></param>
		/// <returns></returns>
		private static string FormatExchange(DocProject docProject, DocModelView docView, DocExchangeDefinition def, Dictionary<string, DocObject> mapEntity, Dictionary<string, string> mapSchema, DocPublication docPublication)
		{
			// format content
			StringBuilder sbMain = new StringBuilder();

			if (!String.IsNullOrEmpty(def.ExchangeClass))
			{
				sbMain.AppendLine("<table class=\"gridtable\">");
				sbMain.AppendLine("<tr><th>Process</th><th>Sender</th><th>Receiver</th></tr>");
				sbMain.AppendLine("<tr><td>" + def.ExchangeClass + "</td><td>" + def.SenderClass + "</td><td>" + def.ReceiverClass + "</td></tr>");
				sbMain.AppendLine("</table>");
			}

			// 1. manual content
			sbMain.Append(def.DocumentationHtml());

			// 2. map of entities and templates -- Identity | Template | Import | Export
			sbMain.AppendLine("<p></p>");//This exchange involves the following entities:</p>");

			SortedList<string, DocConceptRoot> sortlist = new SortedList<string, DocConceptRoot>();

			foreach (DocConceptRoot docRoot in docView.ConceptRoots)
			{
				if (docRoot.ApplicableEntity != null)
				{
					foreach (DocTemplateUsage docUsage in docRoot.Concepts)
					{
						foreach (DocExchangeItem docReq in docUsage.Exchanges)
						{
							//if (docReq.Exchange == def && docReq.Requirement != DocExchangeRequirementEnum.NotRelevant && docReq.Requirement != DocExchangeRequirementEnum.Excluded && !sortlist.ContainsKey(docRoot.ApplicableEntity.Name))
							if (docReq.Exchange == def && docReq.Requirement != DocExchangeRequirementEnum.NotRelevant && !sortlist.ContainsKey(docRoot.ApplicableEntity.Name))
							{
								sortlist.Add(docRoot.ApplicableEntity.Name, docRoot);
							}
						}
					}
				}
			}

			bool externaldataconstraints = false;

			// new style - table
			StringBuilder sb = new StringBuilder();
			sb.AppendLine("<table class=\"exchange\">");
			sb.AppendLine("<tr><th colspan=\"5\"><img src=\"../../../img/mvd-" + MakeLinkName(def) + ".png\" />&nbsp; " + def.Name + "</th></tr>");
			sb.AppendLine("<tr><th>Entity/Concept</th><th>Attributes</th><th>Constraints</th><th>I</th><th>E</th></tr>");
			foreach (string ent in sortlist.Keys)
			{
				DocConceptRoot docRoot = sortlist[ent];

				sb.Append("<tr><td colspan=\"5\"><b><i>");
				sb.Append(docRoot.ApplicableEntity.Name);
				sb.AppendLine("</i></b></td></tr>");

				// determine schema
				string schema = mapSchema[ent];

				foreach (DocTemplateUsage docConcept in docRoot.Concepts)
				{
					if (docConcept.Definition != null)
					{
						DocExchangeRequirementEnum reqImport = DocExchangeRequirementEnum.NotRelevant;
						DocExchangeRequirementEnum reqExport = DocExchangeRequirementEnum.NotRelevant;
						foreach (DocExchangeItem docReq in docConcept.Exchanges)
						{
							if (docReq.Exchange == def)
							{
								if (docReq.Applicability == DocExchangeApplicabilityEnum.Export)
								{
									reqExport = docReq.Requirement;
								}
								else if (docReq.Applicability == DocExchangeApplicabilityEnum.Import)
								{
									reqImport = docReq.Requirement;
								}
							}
						}

						if (reqImport != DocExchangeRequirementEnum.NotRelevant || reqExport != DocExchangeRequirementEnum.NotRelevant)
						{
							if (docConcept.Definition.Uuid.Equals(DocTemplateDefinition.guidTemplateMapping))//   Name.Equals("External Data Constraints"))
							{
								if (!externaldataconstraints)
								{
									// show heading for first time
									//sbMain.Append("<h4>Information Requirements</h4>");// for tabular formats</h4>");
									externaldataconstraints = true;
								}

								// new for GSA: cross-tab report to show mappings between exchanges and applications and vice-versa
								List<DocModelView> listViewCross = new List<DocModelView>();
								if (true)//docPublication.Comparison)
								{
									foreach (DocModelView docEachView in docPublication.Views)
									{
										if (docEachView != docView && !docEachView.ModelViews.Contains(docView))
										{
											listViewCross.Add(docEachView);
										}
									}
								}

								// table and description
								sbMain.AppendLine("<a id=\"" + MakeLinkName(docConcept) + "\"/>");


								if (!String.IsNullOrEmpty(docConcept.Name))
								{
									sbMain.Append("<h5>" + docConcept.Name + "</h5>"); // changed for IFC-Bridge
								}
								else
								{
									//sbMain.Append("<h5>" + docConcept.Name + "</h5>");
									sbMain.Append("<h5>" + docRoot.Name + "</h5>"); // changed for IFC-Bridge
								}
								sbMain.Append(docConcept.DocumentationHtml());

								sbMain.AppendLine("<table class=\"gridtable\">");
								sbMain.Append("<tr><th rowspan=\"2\">Column</th><th rowspan=\"2\">Mapping</th><th rowspan=\"2\">Definition</th>");
								foreach (DocModelView docViewCross in listViewCross)
								{
									int colspan = docViewCross.ModelViews.Count + docViewCross.Exchanges.Count;
									sbMain.Append("<th colspan=\"" + colspan + "\">" + docViewCross.Name + "</th>");
#if false
                                    foreach (DocExchangeDefinition docExchangeCross in docViewCross.Exchanges)
                                    {
                                        sbMain.Append("<th><a href=\"../../views/");
                                        sbMain.Append(MakeLinkName(docViewCross));
                                        sbMain.Append("/");
                                        sbMain.Append(MakeLinkName(docExchangeCross));
                                        sbMain.Append(".html\"><img width=\"16\" src=\"../../../img/mvd-");
                                        sbMain.Append(MakeLinkName(docExchangeCross));
                                        sbMain.Append(".png\" title=\"");
                                        sbMain.Append(docExchangeCross.Name);
                                        sbMain.Append("\"/></a></th>");
                                    }
#endif
								}
								sbMain.AppendLine("</tr>");
								sbMain.AppendLine("<tr>");
								foreach (DocModelView docViewCross in listViewCross)
								{
									foreach (DocModelView docViewMinor in docViewCross.ModelViews)
									{
										sbMain.Append("<th>" + docViewMinor.Name + "</th>");
									}

									foreach (DocExchangeDefinition docExchange in docViewCross.Exchanges)
									{
										sbMain.Append("<th>" + docExchange.Name + "</th>");
									}
								}
								sbMain.AppendLine("</tr>");

								foreach (DocTemplateItem docItem in docConcept.Items)
								{
									string name = docItem.GetParameterValue("Name");
									string refv = docItem.GetParameterValue("Reference");
									string disp = "#" + docItem.GetColor().ToArgb().ToString("X8").Substring(2, 6); //docItem.GetParameterValue("Color");
									string mapp = FormatReference(docProject, refv);
									string desc = docItem.DocumentationHtmlNoParagraphs();// "";


									CvtValuePath valpath = CvtValuePath.Parse(refv, mapEntity);
									if (valpath != null && String.IsNullOrEmpty(desc))
									{
										desc = valpath.GetDescription(mapEntity, docView);
									}

									string style = "";
									if (!String.IsNullOrEmpty(disp))// && disp.StartsWith("#") && Int32.TryParse(disp.Substring(1), out colorval))
									{
										// interpret colors as disposition -- todo: migrate to well-defined values
										style = " style=\"background-color:" + disp + ";\"";
									}

									sbMain.Append("<tr><td" + style + ">" + name + "</td><td>" + mapp + "</td><td>" + desc + "</td>");
									// don't include notes anymore>> sbMain.Append("<td>" + docItem.Documentation + "</td>");
									foreach (DocModelView docViewCross in listViewCross)
									{
										// subviews
										foreach (DocModelView docViewMinor in docViewCross.ModelViews)
										{
											sbMain.Append("<td>");

											// check for usage within model view (or a sub-view)
											DocTemplateItem check = CheckForReference(docProject, docViewMinor, null, refv);
											if (check != null)
											{
												// link to more info...

												sbMain.Append("<img width=\"16\" src=\"../../../img/attr-mandatory.png\" />");
											}

											sbMain.Append("</td>");
										}

#if true // todo 20170808: refactor to use CheckForReference...
										foreach (DocExchangeDefinition docExchangeCross in docViewCross.Exchanges)
										{
											// find any table in that exchange containing a matching mapping
											sbMain.Append("<td>");

											foreach (DocConceptRoot docRootCross in docViewCross.ConceptRoots)
											{
												foreach (DocTemplateUsage docConceptCross in docRootCross.Concepts)
												{
													if (docConceptCross.Definition != null && docConceptCross.Definition.Uuid.Equals(DocTemplateDefinition.guidTemplateMapping))//Name.Equals("External Data Constraints"))
													{
														DocExchangeRequirementEnum reqImportCross = DocExchangeRequirementEnum.NotRelevant;
														DocExchangeRequirementEnum reqExportCross = DocExchangeRequirementEnum.NotRelevant;
														foreach (DocExchangeItem docReq in docConceptCross.Exchanges)
														{
															if (docReq.Exchange == docExchangeCross)
															{
																if (docReq.Applicability == DocExchangeApplicabilityEnum.Export)
																{
																	reqExportCross = docReq.Requirement;
																}
																else if (docReq.Applicability == DocExchangeApplicabilityEnum.Import)
																{
																	reqImportCross = docReq.Requirement;
																}

															}
														}

														// found it, now look for any matching data mappings
														if (reqImportCross != DocExchangeRequirementEnum.NotRelevant || reqExportCross != DocExchangeRequirementEnum.NotRelevant)
														{
															foreach (DocTemplateItem docItemCross in docConceptCross.Items)
															{
																string crossrefv = docItemCross.GetParameterValue("Reference");
																if (crossrefv != null && crossrefv.Equals(refv))
																{
																	string crosstabl = docItemCross.GetParameterValue("Table");
																	string crossname = docItemCross.GetParameterValue("Name");

																	sbMain.Append("<a href=\"../../views/");
																	sbMain.Append(MakeLinkName(docViewCross));
																	sbMain.Append("/");
																	sbMain.Append(MakeLinkName(docExchangeCross));
																	sbMain.Append(".html\"><img width=\"16\" src=\"../../../img/attr-mandatory");
																	sbMain.Append(".png\" title=\"");
																	sbMain.Append(docExchangeCross.Name + ": " + crosstabl + "." + crossname);
																	sbMain.Append("\"/></a>");

																	//sbMain.Append(crosstabl + "." + crossname); //... use icon to show import or export, with tooltip showing name...
																	break;
																}
															}
														}

													}
												}
											}
											sbMain.Append("</td>");
										}
#endif
									}
									sbMain.AppendLine("</tr>");
								}
								sbMain.AppendLine("</table>");

								// bring out separately
								//string table = FormatConceptTable(docProject, docView, docRoot.ApplicableEntity, docRoot, docConcept, mapEntity, mapSchema);
								//sbMain.Append(table);
							}
							else
							{
								sb.Append("<tr><td>&nbsp;&nbsp;<a href=\"../../templates/");
								sb.Append(MakeLinkName(docConcept.Definition));
								sb.Append(".html\">");
								sb.Append(docConcept.Definition.Name);
								sb.Append("</a></td><td>");

								bool first = true;
								if (docConcept.Definition.Rules != null)
								{
									foreach (DocModelRule docRule in docConcept.Definition.Rules)
									{
										if (!first)
										{
											sb.Append("<br/>");
										}
										sb.Append(docRule.Name);
										first = false;
									}
								}
								sb.Append("</td><td>");


								string table = FormatConceptTable(docProject, docView, docRoot.ApplicableEntity, docRoot, docConcept, mapEntity, mapSchema);
								sb.Append(table);

								sb.Append("</td><td>");
								AppendRequirement(sb, reqImport, "import", 3);
								sb.Append("</td><td>");
								AppendRequirement(sb, reqExport, "export",  3);
								sb.AppendLine("</td></tr>");
							}
						}
					}
				}

			}
			sb.AppendLine("</table>");

			// then general table for IFC
			if (!docPublication.Exchanges)
			{
				sbMain.AppendLine("<h4>Data Requirements for IFC formats</h4>");
				sbMain.Append(sb.ToString());
			}

			return sbMain.ToString();
		}

		/// <summary>
		/// 
		/// </summary>
		/// <param name="docViewCross">Required view to check</param>
		/// <param name="docExchangeCross">Optional exchange to check</param>
		/// <param name="refv">Required mapping expresion</param>
		/// <returns></returns>
		private static DocTemplateItem CheckForReference(DocProject docProject, DocModelView docViewCross, DocExchangeDefinition docExchangeCross, string refv)
		{
			// recurse to base view
			if (!String.IsNullOrEmpty(docViewCross.BaseView))
			{
				DocModelView docBase = docProject.GetView(Guid.Parse(docViewCross.BaseView));
				if (docBase != null)
				{
					DocTemplateItem docItemBase = CheckForReference(docProject, docBase, null, refv);
					if (docItemBase != null)
					{
						return docItemBase;
					}
				}
			}

			foreach (DocConceptRoot docRootCross in docViewCross.ConceptRoots)
			{
				foreach (DocTemplateUsage docConceptCross in docRootCross.Concepts)
				{
					if (docConceptCross.Definition != null && docConceptCross.Definition.Uuid.Equals(DocTemplateDefinition.guidTemplateMapping))//Name.Equals("External Data Constraints"))
					{
						DocExchangeRequirementEnum reqImportCross = DocExchangeRequirementEnum.NotRelevant;
						DocExchangeRequirementEnum reqExportCross = DocExchangeRequirementEnum.NotRelevant;
						foreach (DocExchangeItem docReq in docConceptCross.Exchanges)
						{
							if (docExchangeCross == null || docReq.Exchange == docExchangeCross)
							{
								if (docReq.Applicability == DocExchangeApplicabilityEnum.Export)
								{
									reqExportCross = docReq.Requirement;
								}
								else if (docReq.Applicability == DocExchangeApplicabilityEnum.Import)
								{
									reqImportCross = docReq.Requirement;
								}

							}
						}

						// found it, now look for any matching data mappings
						if (reqImportCross != DocExchangeRequirementEnum.NotRelevant || reqExportCross != DocExchangeRequirementEnum.NotRelevant)
						{
							foreach (DocTemplateItem docItemCross in docConceptCross.Items)
							{
								string crossrefv = docItemCross.GetParameterValue("Reference");
								if (crossrefv != null && crossrefv.Equals(refv))
								{
									return docItemCross;

									/*
                                    string crosstabl = docItemCross.GetParameterValue("Table");
                                    string crossname = docItemCross.GetParameterValue("Name");

                                    sbMain.Append("<a href=\"../../views/");
                                    sbMain.Append(MakeLinkName(docViewCross));
                                    sbMain.Append("/");
                                    sbMain.Append(MakeLinkName(docExchangeCross));
                                    sbMain.Append(".html\"><img width=\"16\" src=\"../../../img/attr-mandatory");
                                    sbMain.Append(".png\" title=\"");
                                    sbMain.Append(docExchangeCross.Name + ": " + crosstabl + "." + crossname);
                                    sbMain.Append("\"/></a>");

                                    //sbMain.Append(crosstabl + "." + crossname); //... use icon to show import or export, with tooltip showing name...
                                    break;
                                     */
								}
							}
						}

					}
				}
			}

			// recurse through component views
			foreach (DocModelView docViewSub in docViewCross.ModelViews)
			{
				DocTemplateItem docItemSub = CheckForReference(docProject, docViewSub, null, refv);
				if (docItemSub != null)
					return docItemSub;
			}

			return null;
		}

		/// <summary>
		/// 
		/// </summary>
		/// <param name="docTemplate"></param>
		/// <param name="path">Path of templates</param>
		/// <param name="mapEntity"></param>
		/// <param name="mapSchema"></param>
		private static void GenerateTemplateLink(List<DocTemplateDefinition> path, Dictionary<string, DocObject> mapEntity, Dictionary<string, string> mapSchema, Dictionary<DocObject, bool> included, DocPublication docPublication, string dirpath)
		{
			DocTemplateDefinition docTemplateLast = path[path.Count - 1];

			if (included != null && !included.ContainsKey(docTemplateLast))
				return;

			// flat list -- requires unique template names
			StringBuilder sbFile = new StringBuilder();
			sbFile.Append(dirpath);
			sbFile.Append(@"\link\");
			sbFile.Append(MakeLinkName(docTemplateLast));
			sbFile.Append(".html");

			StringBuilder sbLink = new StringBuilder();
			sbLink.Append("../schema/templates/");
			sbLink.Append(MakeLinkName(docTemplateLast));
			sbLink.Append(".html");

			using (FormatHTM htmLink = new FormatHTM(sbFile.ToString(), mapEntity, mapSchema, included))
			{
				htmLink.WriteLinkPage(sbLink.ToString(), docPublication);
			}

			if (docTemplateLast.Templates != null)
			{
				foreach (DocTemplateDefinition docSub in docTemplateLast.Templates)
				{
					path.Add(docSub);
					GenerateTemplateLink(path, mapEntity, mapSchema, included, docPublication, dirpath);
					path.RemoveAt(path.Count - 1);
				}
			}
		}

		/// <summary>
		/// 
		/// </summary>
		/// <param name="docTemplate"></param>
		/// <param name="path">Path of templates</param>
		/// <param name="mapEntity"></param>
		/// <param name="mapSchema"></param>
		private static void GenerateExampleLink(List<DocExample> path, Dictionary<string, DocObject> mapEntity, Dictionary<string, string> mapSchema, Dictionary<DocObject, bool> included, DocPublication docPublication, string dirpath)
		{
			DocExample docTemplateLast = path[path.Count - 1];

			if (included != null && !included.ContainsKey(docTemplateLast))
				return;

			// flat list -- requires unique template names
			StringBuilder sbFile = new StringBuilder();
			sbFile.Append(dirpath);
			sbFile.Append(@"\link\");
			sbFile.Append(MakeLinkName(docTemplateLast));
			sbFile.Append(".html");

			StringBuilder sbLink = new StringBuilder();
			sbLink.Append("../annex/annex-e/");
			sbLink.Append(MakeLinkName(docTemplateLast));
			sbLink.Append(".html");

			using (FormatHTM htmLink = new FormatHTM(sbFile.ToString(), mapEntity, mapSchema, included))
			{
				htmLink.WriteLinkPage(sbLink.ToString(), docPublication);
			}

			if (docTemplateLast.Examples != null)
			{
				foreach (DocExample docSub in docTemplateLast.Examples)
				{
					path.Add(docSub);
					GenerateExampleLink(path, mapEntity, mapSchema, included, docPublication, dirpath);
					path.RemoveAt(path.Count - 1);
				}
			}
		}


		private static string FormatDiagram(DocProject docProject, DocObject def, DocModelView docView, List<ContentRef> listFigures, Dictionary<string, DocObject> mapEntity, Dictionary<string, string> mapSchema, string path)
		{
			// return if nothing to generate
			if (def is DocTemplateDefinition)
			{
				DocTemplateDefinition dtd = (DocTemplateDefinition)def;
				if (dtd.Rules == null || dtd.Rules.Count == 0)
					return null;
			}
			else if (def is DocEntity)
			{
			}
			else
			{
				return null;
			}

			// create the figure file
			string filename = MakeLinkName(def) + ".png";
			Dictionary<Rectangle, SEntity> layout = new Dictionary<Rectangle, SEntity>();
			{
				try
				{
					if (def is DocTemplateDefinition)
					{
						System.IO.Directory.CreateDirectory(path + "\\schema\\templates\\diagrams");
						using (Image image = IfcDoc.Format.PNG.FormatPNG.CreateTemplateDiagram((DocTemplateDefinition)def, layout, docProject, null))
						{
							if (image != null)
							{
								string filepath = path + "\\schema\\templates\\diagrams\\" + filename;
								image.Save(filepath, System.Drawing.Imaging.ImageFormat.Png);
							}
						}
					}
					else if (def is DocEntity) // no longer used directly; now for each model view in annex D
					{
						System.IO.Directory.CreateDirectory(path + "\\diagrams\\" + MakeLinkName(docView));
						using (Image image = IfcDoc.Format.PNG.FormatPNG.CreateConceptDiagram((DocEntity)def, docView, layout, docProject, null))
						{
							string filepath = path + "\\diagrams\\" + MakeLinkName(docView) + "\\" + filename;
							image.Save(filepath, System.Drawing.Imaging.ImageFormat.Png);
						}
					}
				}
				catch
				{
				}
			}

			// 2. figure
			StringBuilder sb = new StringBuilder();
			if (def is DocTemplateDefinition)
			{
				listFigures.Add(new ContentRef(def.Name + " instance diagram", def));

				// Per ISO guidelines, all figures must be referenced from text.
				sb.Append("<p class=\"fig-ref\">Figure ");
				sb.Append(listFigures.Count);
				sb.Append(" illustrates an instance diagram.</p>\r\n");
			}

			// include the figure with formatting below per ISO
			sb.Append("<table><tr><td><img alt=\"");
			sb.Append(def.Name);

			if (def is DocTemplateDefinition)
			{
				sb.Append("\" src=\"./diagrams/");
			}
			else
			{
				sb.Append("\" src=\"../../../diagrams/");
				sb.Append(MakeLinkName(docView));
				sb.Append("/");
			}
			sb.Append(filename);
			sb.Append("\" usemap=\"#f");
			sb.Append(listFigures.Count.ToString());
			sb.Append("\">");
			sb.Append("<map name=\"f");
			sb.Append(listFigures.Count.ToString());
			sb.Append("\">");
			foreach (Rectangle rc in layout.Keys)
			{
				SEntity target = layout[rc];

				DocModelRule rule = target as DocModelRule;
				DocObject ruleObject = null;
				string strschema = null;

				string typename = null;
				if (rule != null)
				{
					typename = rule.Name;
				}
				else if (def is DocTemplateDefinition)
				{
					DocTemplateDefinition dtd = (DocTemplateDefinition)def;
					typename = dtd.Type;
				}
				else if (def is DocObject)
				{
					typename = def.Name;
				}

				string caption = null;
				string hyperlink = null;
				if (target is DocTemplateDefinition)
				{
					DocTemplateDefinition dtd = (DocTemplateDefinition)target;
					string relative = @"./";
					if (def is DocEntity)
					{
						relative = "../../../schema/templates/";
					}

					caption = dtd.Name;
					hyperlink = relative + MakeLinkName(dtd) + ".html";
				}
				else if (typename != null && mapEntity.TryGetValue(typename, out ruleObject) && mapSchema.TryGetValue(typename, out strschema))
				{
					string relative = @"../";
					if (def is DocEntity)
					{
						relative = "../../../schema/";
					}

					// hyperlink to IFC entity                       
					// replace it with hyperlink               
					caption = ruleObject.Name;
					hyperlink = relative + strschema.ToLower() + @"/lexical/" + ruleObject.Name.ToLower() + ".html";
				}

				if (hyperlink != null)
				{
					int indent = 0;
					sb.Append("<area shape=\"rect\" coords=\"");
					sb.Append(rc.Left + indent);
					sb.Append(",");
					sb.Append(rc.Top + indent);
					sb.Append(",");
					sb.Append(rc.Right + indent);
					sb.Append(",");
					sb.Append(rc.Bottom + indent);
					sb.Append("\" href=\"");
					sb.Append(hyperlink);
					sb.Append("\" alt=\"");
					sb.Append(caption);
					sb.Append("\" />");
				}

			}
			sb.Append("</map>");

			// number figures in templates, but not annex
			if (def is DocTemplateDefinition)
			{
				sb.Append("</td></tr>");
				sb.Append("<tr><td><p class=\"figure\">Figure ");
				sb.Append(listFigures.Count);
				sb.Append(" &mdash; ");
				sb.Append(def.Name);
				sb.Append("</p></td></tr>");
			}

			sb.Append("</table>\r\n");
			sb.AppendLine();

			return sb.ToString();
		}


		private static string FormatTemplate(
			DocProject docProject,
			DocPublication docPublication,
			DocTemplateDefinition def,
			List<ContentRef> listFigures,
			List<ContentRef> listTables,
			Dictionary<string, DocObject> mapEntity,
			Dictionary<string, string> mapSchema,
			Dictionary<DocObject, bool> included,
			string path)
		{
			// format content
			StringBuilder sb = new StringBuilder();

			// 1. manual content
			sb.Append(def.DocumentationHtml());

			// 2. instance diagram
			sb.Append(FormatDiagram(docProject, def, null, listFigures, mapEntity, mapSchema, path));

			// 3. entity list                
			{
				foreach (DocModelView docView in docProject.ModelViews)
				{
					if ((included == null || included.ContainsKey(docView)) && docView.Exchanges.Count > 0)
					{
						SortedList<string, DocTemplateUsage> mapUsage = new SortedList<string, DocTemplateUsage>();

						foreach (DocConceptRoot docRoot in docView.ConceptRoots)
						{
							if (docRoot.ApplicableEntity != null)
							{
								foreach (DocTemplateUsage docUsage in docRoot.Concepts)
								{
									if (docUsage.Definition == def && !mapUsage.ContainsKey(docRoot.ApplicableEntity.Name))
									{
										mapUsage.Add(docRoot.ApplicableEntity.Name, docUsage);
									}
								}
							}
						}

						if (mapUsage.Count > 0)
						{
							sb.AppendLine("<hr/>");
							sb.AppendLine("<h4>" + docView.Name + "</h4>");
							sb.AppendLine("<p>This concept shall be applied as follows to the exchanges. All inherited classes from the classes shown in the figure can be instanciated.</p>");
							int cExchange = docView.Exchanges.Count;

							sb.AppendLine("<table class=\"exchange\">");
							sb.Append("<tr><th>Entity </th>");

							if (docPublication.Exchanges)
							{
								foreach (DocExchangeDefinition docExchange in docView.Exchanges)
								{
									sb.Append("<th style=\"text-align: center\"><a href=\"../views/");
									sb.Append(MakeLinkName(docView));
									sb.Append("/");
									sb.Append(MakeLinkName(docExchange));
									sb.Append(".html\"><img width=\"16\" src=\"../../img/mvd-");
									sb.Append(MakeLinkName(docExchange));
									sb.Append(".png\" title=\"");
									sb.Append(docExchange.Name);
									sb.Append($"\"/></a><br>{docExchange.Name}</th>");
									sb.AppendLine();
								}
							}
							sb.Append("</tr>");

							foreach (string entname in mapUsage.Keys)
							{
								DocTemplateUsage docUsage = mapUsage[entname];
								if (docUsage.Definition == def)
								{
									sb.Append("<tr><td><i>");
									sb.Append(entname);
									sb.Append("</i></td>");

									if (docPublication.Exchanges)
									{
										foreach (DocExchangeDefinition docExchange in docView.Exchanges)
										{
											sb.Append("<td style=\"text-align:center\">");

											DocExchangeRequirementEnum reqImport = DocExchangeRequirementEnum.NotRelevant;
											DocExchangeRequirementEnum reqExport = DocExchangeRequirementEnum.NotRelevant;

											foreach (DocExchangeItem dti in docUsage.Exchanges)
											{
												if (dti.Exchange == docExchange)
												{
													if (dti.Applicability == DocExchangeApplicabilityEnum.Import)
													{
														reqImport = dti.Requirement;
													}
													else if (dti.Applicability == DocExchangeApplicabilityEnum.Export)
													{
														reqExport = dti.Requirement;
													}
												}
											}

											AppendRequirement(sb, reqImport, "import", 2);
											sb.Append("<br/>");
											AppendRequirement(sb, reqExport, "export", 2);

											sb.Append("</td>");
											sb.AppendLine();
										}
									}

									sb.AppendLine("</tr>");
								}
							}

							sb.AppendLine("</table>");
						}
					}
				}

			}

			return sb.ToString();
		}

		private static string FormatRequirements(DocTemplateUsage eachusage, DocModelView docModel, bool showexchanges)
		{
			if (eachusage.Exchanges == null || eachusage.Exchanges.Count == 0 && (eachusage.Items.Count == 0 || eachusage.Definition.Type == ""))
				return null; // don't show if no rules or exchanges

			//if (!Properties.Settings.Default.Requirement)
			//    return String.Empty;

			StringBuilder sb = new StringBuilder();

			if (showexchanges && docModel.Exchanges.Count > 0)
			{
				sb.AppendLine("<table class=\"exchange\">");

				sb.AppendLine("<tr>");
				sb.AppendLine("<th>Exchange</th>");
				foreach (DocExchangeDefinition docExchange in docModel.Exchanges)
				{
					sb.Append("<th><a href=\"../../views/");
					sb.Append(MakeLinkName(docModel));
					sb.Append("/");
					sb.Append(MakeLinkName(docExchange));
					sb.Append(".html\"><img width=\"16\" src=\"../../../img/mvd-");
					sb.Append(MakeLinkName(docExchange));
					sb.Append(".png\" title=\"");
					sb.Append(docExchange.Name);
					sb.Append("\"/></a></th>");
					sb.AppendLine();
				}
				sb.AppendLine("</tr>");

				sb.AppendLine("<tr>");
				sb.AppendLine("<td>Import</td>");
				foreach (DocExchangeDefinition docExchange in docModel.Exchanges)
				{
					sb.Append("<td>");
					foreach (DocExchangeItem dti in eachusage.Exchanges)
					{
						if (dti.Exchange == docExchange && dti.Applicability == DocExchangeApplicabilityEnum.Import)
						{
							AppendRequirement(sb, dti.Requirement, "import", 3);
						}
					}
					sb.Append("</td>");
					sb.AppendLine();
				}
				sb.AppendLine("</tr>");

				sb.AppendLine("<tr>");
				sb.AppendLine("<td>Export</td>");
				foreach (DocExchangeDefinition docExchange in docModel.Exchanges)
				{
					sb.Append("<td>");
					foreach (DocExchangeItem dti in eachusage.Exchanges)
					{
						if (dti.Exchange == docExchange && dti.Applicability == DocExchangeApplicabilityEnum.Export)
						{
							AppendRequirement(sb, dti.Requirement, "export", 3);
						}
					}
					sb.Append("</td>");
					sb.AppendLine();
				}
				sb.AppendLine("</tr>");

				sb.AppendLine("</table>");
			}
			return sb.ToString();
		}

		private static void BuildViewList(DocProject docProject, List<DocModelView> listView, DocModelView docView)
		{
			if (listView.Contains(docView))
				return;

			// add base view if any
			if (!String.IsNullOrEmpty(docView.BaseView))
			{
				DocModelView docBase = docProject.GetView(Guid.Parse(docView.BaseView));
				if (docBase != null && docBase != docView)
				{
					BuildViewList(docProject, listView, docBase);
				}
			}

			// add this view
			listView.Add(docView);

			// add component views
			foreach (DocModelView docSub in docView.ModelViews)
			{
				BuildViewList(docProject, listView, docSub);
			}
		}

		/// <summary>
		/// 
		/// </summary>
		/// <param name="docProject"></param>
		/// <param name="docView">Specified view, or NULL for all views within scope.</param>
		/// <param name="mapEntity"></param>
		/// <param name="mapSchema"></param>
		/// <param name="sbData">Formats as CSV.</param>
		/// <returns></returns>
		private static string FormatView(DocProject docProject, DocPublication docPublication, DocModelView docView, Dictionary<string, DocObject> mapEntity, Dictionary<string, string> mapSchema, StringBuilder sbData)
		{
			// format content
			StringBuilder sb = new StringBuilder();

			// 1. manual content
			if (docView != null)
			{
				sb.Append(docView.DocumentationHtml());
			}

			// V12.0: use concepts directly

			foreach (DocConceptRoot docRoot in docView.ConceptRoots)
			{
				if (docRoot.Name != null)
				{
					sb.AppendLine("<h5>" + docRoot.Name + "</h5>");
					sb.Append(docRoot.DocumentationHtml());
				}


				// now generate requirements table
				sb.AppendLine("<table class=\"gridtable\">");
				sb.AppendLine("<tr><th>Field</th><th>Mapping</th><th>Definition</th>");
				foreach (DocExchangeDefinition docEachExchange in docView.Exchanges)
				{
					sb.Append("<th>" + docEachExchange.Name + "</th>");
				}
				sb.AppendLine("</tr>");

				// query row
				sb.Append("<tr><th>(Query)</th><th>");
				if (docRoot.ApplicableTemplate != null)
				{
					CvtValuePath valpathFilter = CvtValuePath.FromTemplateDefinition(docRoot.ApplicableTemplate, docProject);
					if (valpathFilter != null)
					{
						string refv = valpathFilter.ToString();
						string mapp = FormatReference(docProject, refv);
						sb.Append(mapp);
					}
					else if (docRoot.ApplicableEntity != null)
					{
						string mapp = FormatReference(docProject, docRoot.ApplicableEntity.Name);
						sb.AppendLine(mapp);
					}
				}
				else if (docRoot.ApplicableEntity != null)
				{
					string mapp = FormatReference(docProject, docRoot.ApplicableEntity.Name);
					sb.AppendLine(mapp);
				}
				sb.Append("</th><th>");
				sb.Append(docRoot.DocumentationHtmlNoParagraphs());
				sb.Append("</th>");
				foreach (DocExchangeDefinition docEachExchange in docView.Exchanges)
				{
					sb.Append("<th></th>");
				}
				sb.AppendLine("</tr>");

				foreach (DocTemplateUsage docUsage in docRoot.Concepts)
				{
					CvtValuePath valpath = null;
					if (docUsage.Definition != null && docUsage.Definition.Rules.Count > 0)
					{
						valpath = CvtValuePath.FromTemplateDefinition(docUsage.Definition, docProject);
					}

					string name = docUsage.Name;
					string refv = "";
					string disp = null;// "#" + docItem.GetColor().ToArgb().ToString("X8").Substring(2, 6);
					string desc = docUsage.DocumentationHtml();

					if (valpath != null)
					{
						refv = valpath.ToString();
					}
					string mapp = FormatReference(docProject, refv);

					if (valpath != null && String.IsNullOrEmpty(desc))
					{
						desc = valpath.GetDescription(mapEntity, docView);
					}

					string style = "";
					if (!String.IsNullOrEmpty(disp))
					{
						style = " style=\"background-color:" + disp + ";\"";
					}

					sb.Append("<tr><td" + style + ">" + name + "</td><td>" + mapp + "</td><td>" + desc + "</td>");

					for (int iExchange = 0; iExchange < docView.Exchanges.Count; iExchange++)
					{
						sb.Append("<td>");

						// check if exchange is referenced
						DocExchangeDefinition docExchange = docView.Exchanges[iExchange];
						foreach (DocExchangeItem docExchangeItem in docUsage.Exchanges)
						{
							if (docExchangeItem.Exchange == docExchange)
							{
								string iconFileName = string.Empty;	
								switch (docExchangeItem.Requirement)
								{
									case DocExchangeRequirementEnum.Mandatory:
										iconFileName = "attr-mandatory.png";
										break;
									case DocExchangeRequirementEnum.Optional:
										iconFileName = "attr-optional.png";
										break;
									case DocExchangeRequirementEnum.Excluded:
										iconFileName = "attr-excluded.png";
										break;
									case DocExchangeRequirementEnum.NotRecommended:
										iconFileName = "attr-notrelevant.png";
										break;
									case DocExchangeRequirementEnum.NotRelevant:
										iconFileName = "attr-notrelevant.png";
										break;
								}
								if (iconFileName != string.Empty)
									sb.Append($"<img width=\"16\" src=\"../../../img/{iconFileName}\" title=\"{docExchangeItem.Requirement.ToString()}\" />");
							}
						}
						sb.Append("</td>");
					}
					sb.Append("</tr>");
				}
				sb.AppendLine("</table>");
			}

			return sb.ToString();

#if false

            List<DocModelView> listView = new List<DocModelView>();
            if (docView != null)
            {
                BuildViewList(docProject, listView, docView);
                //listView.Add(docView);
            }
            else
            {
                foreach (DocModelView docEachView in docPublication.Views)
                {
                    listView.Add(docEachView);
                }
            }

            // if there's a single view, sort in order of concept roots
            if (listView.Count == 1)
            {

                foreach (DocModelView docEachView in listView)
                {
                    foreach (DocConceptRoot docRoot in docEachView.ConceptRoots)
                    {
                        if (!docRoot.IsDeprecated())
                        {
                            // track the first unique item using a mapping
                            List<DocTemplateItem> listItems = new List<DocTemplateItem>();
                            List<DocTemplateUsage> listUsage = new List<DocTemplateUsage>();

                            // correlate first item with exchanges that include item and any related ones
                            Dictionary<DocTemplateItem, List<DocModelView>> mapView = new Dictionary<DocTemplateItem, List<DocModelView>>();

                            DocConceptRoot docRootDefault = null;
                            DocTemplateUsage docConcDefault = null;

                            foreach (DocTemplateUsage docConcept in docRoot.Concepts)
                            {
                                if (docConcept.Definition != null && docConcept.Definition.Uuid == DocTemplateDefinition.guidTemplateMapping)
                                {
                                    foreach (DocTemplateItem docItem in docConcept.Items)
                                    {
                                        string refItem = docItem.GetParameterValue("Reference");

                                        // is it already define?
                                        bool add = true;

                                        if (refItem != null)
                                        {
                                            foreach (DocTemplateItem docExist in listItems)
                                            {
                                                string refExist = docExist.GetParameterValue("Reference");
                                                if (refItem == refExist)
                                                {
                                                    // already there
                                                    add = false;
                                                    if (!mapView.ContainsKey(docExist))
                                                    {
                                                        mapView.Add(docExist, new List<DocModelView>());
                                                    }
                                                    mapView[docExist].Add(docEachView);

                                                    break;
                                                }
                                            }
                                        }

                                        if (add)
                                        {
                                            listItems.Add(docItem);
                                            listUsage.Add(docConcept);

                                            if (!mapView.ContainsKey(docItem))
                                            {
                                                mapView.Add(docItem, new List<DocModelView>());
                                            }
                                            mapView[docItem].Add(docEachView);

                                            docRootDefault = docRoot;
                                            docConcDefault = docConcept;
                                        }
                                    }
                                }
                            }

                            if (listItems.Count > 0)
                            {
                                if (docRootDefault != null && docRootDefault.Name != null)
                                {
                                    sb.AppendLine("<h5>" + docRootDefault.Name + "</h5>");
                                    sb.Append(docRootDefault.Documentation);
                                }
                                else if (docConcDefault != null && docConcDefault.Name != null)
                                {
                                    sb.AppendLine("<h5>" + docConcDefault.Name + "</h5>");
                                    //sb.Append(docConcDefault.Documentation);
                                }

                                // now generate requirements table
                                sb.AppendLine("<table class=\"gridtable\">");
                                sb.AppendLine("<tr><th>Field</th><th>Mapping</th><th>Definition</th>");

                                foreach (DocExchangeDefinition docEachExchange in docView.Exchanges)
                                {
                                    sb.Append("<th>" + docEachExchange.Name + "</th>");
                                }

                                sb.AppendLine("</tr>");

                                for (int iItem = 0; iItem < listItems.Count; iItem++)
                                {
                                    DocTemplateItem docItem = listItems[iItem];
                                    DocTemplateUsage docUsage = listUsage[iItem];

                                    string name = docItem.GetParameterValue("Name");
                                    string refv = docItem.GetParameterValue("Reference");
                                    string disp = "#" + docItem.GetColor().ToArgb().ToString("X8").Substring(2, 6); //docItem.GetParameterValue("Color");
                                    string mapp = FormatReference(docProject, refv);
                                    string desc = docItem.Documentation;

                                    CvtValuePath valpath = CvtValuePath.Parse(refv, mapEntity);
                                    if (valpath != null && String.IsNullOrEmpty(desc))
                                    {
                                        desc = valpath.GetDescription(mapEntity, docView);
                                    }

                                    string style = "";
                                    if (!String.IsNullOrEmpty(disp))
                                    {
                                        style = " style=\"background-color:" + disp + ";\"";
                                    }

                                    sb.Append("<tr><td" + style + ">" + name + "</td><td>" + mapp + "</td><td>" + desc + "</td>");

                                    for (int iExchange = 0; iExchange < docView.Exchanges.Count; iExchange++)
                                    {
                                        sb.Append("<td>");

                                        // check if exchange is referenced
                                        DocExchangeDefinition docExchange = docView.Exchanges[iExchange];
                                        foreach (DocExchangeItem docExchangeItem in docUsage.Exchanges)
                                        {
                                            if (docExchangeItem.Exchange == docExchange &&
                                                (docExchangeItem.Requirement == DocExchangeRequirementEnum.Mandatory || docExchangeItem.Requirement == DocExchangeRequirementEnum.Optional))
                                            {
                                                sb.Append("<img width=\"16\" src=\"../../../img/attr-mandatory.png\" title=\"\" />");
                                                break;
                                            }
                                        }

                                        sb.Append("</td>");
                                    }


                                    sb.AppendLine("</tr>");

                                    sbData.AppendLine();
                                }

                                sb.AppendLine("</table>");



                            }
                        }
                    }
                }

           
                //todo: modularize instead of duplicate...
            }
            else
            {
                // otherwise, sort in order of entity
                foreach (DocSection docSection in docProject.Sections)
                {
                    foreach (DocSchema docSchema in docSection.Schemas)
                    {
                        foreach (DocEntity docEntity in docSchema.Entities)
                        {
                            // track the first unique item using a mapping
                            List<DocTemplateItem> listItems = new List<DocTemplateItem>();
                            List<DocTemplateUsage> listUsage = new List<DocTemplateUsage>();

                            // correlate first item with exchanges that include item and any related ones
                            Dictionary<DocTemplateItem, List<DocModelView>> mapView = new Dictionary<DocTemplateItem, List<DocModelView>>();

                            DocConceptRoot docRootDefault = null;

                            foreach (DocModelView docEachView in listView)
                            {
                                foreach (DocConceptRoot docRoot in docEachView.ConceptRoots)
                                {
                                    if (docRoot.ApplicableEntity == docEntity && !docRoot.IsDeprecated())
                                    {
                                        foreach (DocTemplateUsage docConcept in docRoot.Concepts)
                                        {
                                            if (docConcept.Definition != null && docConcept.Definition.Uuid == DocTemplateDefinition.guidTemplateMapping)
                                            {
                                                foreach (DocTemplateItem docItem in docConcept.Items)
                                                {
                                                    string refItem = docItem.GetParameterValue("Reference");

                                                    // is it already define?
                                                    bool add = true;
                                                    foreach (DocTemplateItem docExist in listItems)
                                                    {
                                                        string refExist = docExist.GetParameterValue("Reference");
                                                        if (refItem == refExist)
                                                        {
                                                            // already there
                                                            add = false;
                                                            if (!mapView.ContainsKey(docExist))
                                                            {
                                                                mapView.Add(docExist, new List<DocModelView>());
                                                            }
                                                            mapView[docExist].Add(docEachView);

                                                            break;
                                                        }
                                                    }

                                                    if (add)
                                                    {
                                                        listItems.Add(docItem);
                                                        listUsage.Add(docConcept);

                                                        if (!mapView.ContainsKey(docItem))
                                                        {
                                                            mapView.Add(docItem, new List<DocModelView>());
                                                        }
                                                        mapView[docItem].Add(docEachView);

                                                        docRootDefault = docRoot;
                                                    }
                                                }
                                            }
                                        }
                                    }
                                }
                            }

                            if (listItems.Count > 0)
                            {
                                if (docRootDefault != null && docRootDefault.Name != null)
                                {
                                    sb.AppendLine("<h5>" + docRootDefault.Name + "</h5>");
                                    sb.Append(docRootDefault.Documentation);
                                }
                                else
                                {
                                    sb.AppendLine("<h5>" + docEntity.Name + "</h5>");
                                }

                                // now generate requirements table
                                sb.AppendLine("<table class=\"gridtable\">");
                                sb.AppendLine("<tr><th>Field</th><th>Mapping</th><th>Definition</th>");

                                foreach (DocModelView docEachView in docView.ModelViews)
                                {
                                    sb.Append("<th>" + docEachView.Name + "</th>");
                                }

                                foreach (DocExchangeDefinition docEachExchange in docView.Exchanges)
                                {
                                    sb.Append("<th>" + docEachExchange.Name + "</th>");
                                }

                                sb.AppendLine("</tr>");

                                for (int iItem = 0; iItem < listItems.Count; iItem++)
                                {
                                    DocTemplateItem docItem = listItems[iItem];
                                    DocTemplateUsage docUsage = listUsage[iItem];

                                    string name = docItem.GetParameterValue("Name");
                                    string refv = docItem.GetParameterValue("Reference");
                                    string disp = "#" + docItem.GetColor().ToArgb().ToString("X8").Substring(2, 6); //docItem.GetParameterValue("Color");
                                    string mapp = FormatReference(docProject, refv);
                                    string desc = docItem.Documentation;

                                    if(name.Contains("Beam"))
                                    {
                                        name.ToCharArray();
                                    }

                                    CvtValuePath valpath = CvtValuePath.Parse(refv, mapEntity);
                                    if (valpath != null && String.IsNullOrEmpty(desc))
                                    {
                                        desc = valpath.GetDescription(mapEntity, docView);
                                    }

                                    string style = "";
                                    if (!String.IsNullOrEmpty(disp))
                                    {
                                        style = " style=\"background-color:" + disp + ";\"";
                                    }

                                    if (mapp == null)
                                        mapp = String.Empty;

                                    sb.Append("<tr><td" + style + ">" + name + "</td><td>" + mapp + "</td><td>" + desc + "</td>");

                                    foreach (DocModelView docEachView in docView.ModelViews)
                                    {
                                        sb.Append("<td>");

                                        DocTemplateItem docCross = CheckForReference(docProject, docEachView, null, refv);
                                        if (docCross != null)
                                        {
                                            sb.Append("<img width=\"16\" src=\"../../../img/attr-mandatory.png\" title=\"\" />");
                                        }

                                        sb.Append("</td>");
                                    }

                                    for (int iExchange = 0; iExchange < docView.Exchanges.Count; iExchange++)
                                    {
                                        sb.Append("<td>");

                                        // check if exchange is referenced
                                        DocExchangeDefinition docExchange = docView.Exchanges[iExchange];
                                        foreach (DocExchangeItem docExchangeItem in docUsage.Exchanges)
                                        {
                                            if (docExchangeItem.Exchange == docExchange &&
                                                (docExchangeItem.Requirement == DocExchangeRequirementEnum.Mandatory || docExchangeItem.Requirement == DocExchangeRequirementEnum.Optional))
                                            {
                                                sb.Append("<img width=\"16\" src=\"../../../img/attr-mandatory.png\" title=\"\" />");
                                                break;
                                            }
                                        }

                                        sb.Append("</td>");
                                    }


                                    sb.AppendLine("</tr>");

                                    sbData.AppendLine();
                                }

                                sb.AppendLine("</table>");



                            }
                        }
                    }
                }
            }

            return sb.ToString();
#endif
		}


		private static void AppendRequirement(StringBuilder sb, DocExchangeRequirementEnum req, string reqType, int level)
		{
			// new-style character (allows copy/paste into word without slowdown)
			switch (req)
			{
				case DocExchangeRequirementEnum.Excluded:
					sb.Append($"excluded on {reqType}");
					break;

				case DocExchangeRequirementEnum.Mandatory:
					sb.Append($"required on {reqType}");
					break;

				case DocExchangeRequirementEnum.NotRelevant:
					sb.Append($"not relevant on {reqType}");
					break;

				case DocExchangeRequirementEnum.Optional:
					sb.Append($"optional on {reqType}");
					break;
			}
		}

		private static void BuildExampleList(List<DocExample> listExample, DocExample docExample, DocObject docObject, Dictionary<DocObject, bool> included)
		{
			// check for view reference
			if (included != null)
			{
				bool viewref = false;
				foreach (DocModelView docView in docExample.Views)
				{
					if (included.ContainsKey(docView))
					{
						viewref = true;
						break;
					}
				}

				if (!viewref)
					return;
			}

			if (docExample.ApplicableType != null)
			{
				string[] types = docExample.ApplicableType.Split(new char[] { ',' }, StringSplitOptions.RemoveEmptyEntries);
				foreach (string type in types)
				{
					string[] parts = type.Split(new char[] { '/' }, StringSplitOptions.RemoveEmptyEntries);
					if (parts.Length >= 1)
					{
						if (parts[0].Equals(docObject.Name))
						{
							listExample.Add(docExample);
						}
					}
				}
			}

			// templates
			if (docExample.ApplicableTemplates != null && docObject is DocTemplateDefinition)
			{
				if (docExample.ApplicableTemplates.Contains((DocTemplateDefinition)docObject))
				{
					listExample.Add(docExample);
				}
			}

			// recurse
			foreach (DocExample docSub in docExample.Examples)
			{
				BuildExampleList(listExample, docSub, docObject, included);
			}
		}


		/// <summary>
		/// Generates HTTP-compatible name for object
		/// </summary>
		/// <param name="docobj"></param>
		/// <returns></returns>
		public static string MakeLinkName(DocObject docobj)
		{
			if (docobj == null)
				return null;
		
			if (docobj.Name == null)
				return docobj.Uuid.ToString();
			return MakeLinkName(docobj.Name);
		}

		public static string MakeLinkName(string str)
		{ 
			StringBuilder sb = new StringBuilder();
			if (str !=null)
			for (int i = 0; i < str.Length; i++)
			{
				Char ch = str[i];
				if ((ch >= 'A' && ch <= 'Z') || (ch >= 'a' && ch <= 'z') || (ch >= '0' && ch <= '9') || ch == '-' || ch == '_')
				{
					sb.Append(ch);
				}
				else if (ch == ' ')
				{
					sb.Append('-');
				}
				else if (ch == '.')
				{
					sb.Append('_');
				}
			}

			return sb.ToString().ToLower();
		}

		/// <summary>
		/// If matching figure exists, generates HTML including the figure and increments the figure count.
		/// </summary>
		/// <param name="docProject">The project</param>
		/// <param name="definition">Object for which to find figure.</param>
		/// <param name="dtd">Optional template for which to find figure.</param>
		/// <param name="caption">Caption of definition used in determining figure caption, e.g. 'Beam'</param>
		/// <param name="listFigures">List of figures for determining numbering; appended as applicable by function.</param>
		/// <returns></returns>
		private static string FormatFigure(DocProject docProject, DocObject definition, DocTemplateDefinition dtd, string caption, List<ContentRef> listFigures, string path)
		{
			string title = null;
			string desc = null;
			if (!String.IsNullOrEmpty(caption))
			{
				title = caption;
				desc = caption.Substring(0, 1).ToUpper() + caption.Substring(1);
			}
			else
			{
				title = "<i>" + definition.Name + "</i>";
				desc = title;
			}

			StringBuilder sb = new StringBuilder();

			if (definition is DocDefinition) //TODO: property set figures
			{
				DocSchema docSchema = docProject.GetSchemaOfDefinition((DocDefinition)definition);

				string filename = MakeLinkName(definition);
				if (dtd != null)
				{
					filename += "-" + MakeLinkName(dtd);
				}
				filename += ".png";

				string filepath = path + @"\figures\" + filename;
				if (System.IO.File.Exists(filepath))
				{
					listFigures.Add(new ContentRef(desc, definition));

					// "Sensor", "Port Use Definition" ==> "Sensor Port Use"
					string figuredef = "usage";
					if (dtd != null)
					{
						figuredef = dtd.Name.ToLower();
					}

					// Per ISO guidelines, all figures must be referenced from text.
					sb.Append("<p>Figure ");
					sb.Append(listFigures.Count);
					sb.Append(" illustrates ");
					sb.Append(title.ToLower());
					sb.Append(" ");
					sb.Append(figuredef.ToLower());
					sb.Append(".</p>\r\n");

					// include the figure with formatting below per ISO
					sb.Append("<table><tr><td><img src=\"../../../figures/");
					sb.Append(filename);
					sb.Append("\" alt=\"");
					sb.Append(figuredef);
					sb.Append("\"></td></tr><tr><td><p class=\"figure\">Figure ");
					sb.Append(listFigures.Count);
					sb.Append(" &mdash; ");
					sb.Append(desc);
					sb.Append(" ");
					sb.Append(figuredef);
					sb.Append("</p></td></tr></table>\r\n");
					sb.AppendLine();
				}
			}

			return sb.ToString();
		}

		/// <summary>
		/// 
		/// </summary>
		/// <param name="docProject"></param>
		/// <param name="docModelView"></param>
		/// <param name="entity"></param>
		/// <param name="root"></param>
		/// <param name="usage">Optional usage or NULL to format table from concept root applicability</param>
		/// <param name="mapEntity"></param>
		/// <param name="mapSchema"></param>
		/// <returns></returns>
		private static string FormatConceptTable(
			DocProject docProject,
			DocModelView docModelView,
			DocEntity entity,
			DocConceptRoot root,
			DocTemplateUsage usage,
			Dictionary<string, DocObject> mapEntity,
			Dictionary<string, string> mapSchema)
		{
			StringBuilder sb = new StringBuilder();

			DocTemplateDefinition docTemplate = null;
			DocTemplateItem[] listItems = null;
			if (usage != null)
			{
				docTemplate = usage.Definition;
				listItems = FindTemplateItems(docProject, entity, usage.Definition, docModelView, root);

				if (usage.Override)
				{
					listItems = usage.Items.ToArray();
				}

				if (listItems.Length == 0)
				{
					// scenario for referenced inner templates
					listItems = usage.Items.ToArray();
				}
			}
			else
			{
				docTemplate = root.ApplicableTemplate;
				listItems = root.ApplicableItems.ToArray();
			}

			// new way with table
			DocModelRule[] parameters = docTemplate.GetParameterRules();
			if (parameters != null && parameters.Length > 0 && listItems.Length > 0)
			{
				// check if descriptions are provided
				bool showdescriptions = false;
				foreach (DocTemplateItem item in listItems)
				{
					if (item.Documentation != null)
					{
						showdescriptions = true;
						break;
					}
				}

				// new (IfcDoc 11.6): remove parameters that aren't used
				List<DocModelRule> listParams = new List<DocModelRule>();
				foreach (DocModelRule parameter in parameters)
				{
					DocDefinition docDef = docTemplate.GetParameterType(parameter.Identification, mapEntity);
					if (docDef is DocEntity)
					{
						// always add
						listParams.Add(parameter);
					}
					else
					{
						// check for parameter
						foreach (DocTemplateItem docItem in listItems)
						{
							string value = docItem.GetParameterValue(parameter.Identification);
							if (!String.IsNullOrEmpty(value))
							{
								listParams.Add(parameter);
								break;
							}
						}
					}
				}
				parameters = listParams.ToArray();

				sb.AppendLine("<table class=\"gridtable\">");

				// header
				sb.Append("<tr>");
				foreach (DocModelRule parameter in parameters)
				{
					sb.Append("<th><b>");

					// hack until fixed in data
					if (parameter.Identification.Equals("Name") && docTemplate.Uuid.Equals(DocTemplateDefinition.guidTemplateMapping))
					{
						sb.Append("Column");
					}
					else
					{
						sb.Append(parameter.Identification);
					}
					sb.Append("</b></th>");
				}
				if (showdescriptions)
				{
					sb.Append("<th><b>Description</b></th>");
				}
				sb.AppendLine("</tr>");

				// items
				foreach (DocTemplateItem item in listItems)
				{
					sb.Append("<tr>");
					foreach (DocModelRule parameter in parameters)
					{
						string value = item.GetParameterValue(parameter.Identification);
						string schema = null;

						sb.Append("<td>");
						DocDefinition docDef = docTemplate.GetParameterType(parameter.Identification, mapEntity);
						if (docDef is DocEnumeration)
						{
							if (value != null)
							{
								schema = mapSchema[docDef.Name];

								sb.Append("<a href=\"../../");
								sb.Append(schema.ToLower());
								sb.Append("/lexical/");
								sb.Append(docDef.Name.ToLower());
								sb.Append(".html\">");
								sb.Append(value);
								sb.Append("</a>");
							}
						}
						else if (docDef is DocEntity && docDef.Name.Equals("IfcReference"))
						{
							if (value != null)
							{
								string reftext = FormatReference(docProject, value);
								sb.Append(reftext);
							}
						}
						else if (docDef is DocEntity)
						{
							DocTemplateDefinition docTemplateInner = null;
							if (parameter is DocModelRuleAttribute)
							{
								List<string> cols = new List<string>();
								List<DocTemplateItem> rows = new List<DocTemplateItem>();
								List<DocTemplateUsage> usages = new List<DocTemplateUsage>();

								DocModelRuleAttribute dma = (DocModelRuleAttribute)parameter;
								foreach (DocModelRule docInnerRule in dma.Rules)
								{
									if (docInnerRule is DocModelRuleEntity)
									{
										DocModelRuleEntity dme = (DocModelRuleEntity)docInnerRule;
										if (dme.References.Count == 1)
										{
											docTemplateInner = dme.References[0];

											// new: combine nested tables -- properties are shown together

											DocTemplateUsage docConceptInner = item.GetParameterConcept(parameter.Identification, docTemplateInner);
											if (docConceptInner != null)
											{
												DocModelRule[] innerparameters = docTemplateInner.GetParameterRules();
												foreach (DocModelRule innerparam in innerparameters)
												{
													if (!cols.Contains(innerparam.Identification))
													{
														cols.Add(innerparam.Identification);
													}
												}

												foreach (DocTemplateItem docItemInner in docConceptInner.Items)
												{
													string orderstr = docItemInner.GetParameterValue("Order");
													int ordernum;
													if (docItemInner.Order != 0)
													{
														// V11.6 onwards
														ordernum = docItemInner.Order;

														while (rows.Count < ordernum)
														{
															rows.Add(null);
															usages.Add(null);
														}

														rows[ordernum - 1] = docItemInner;
														usages[ordernum - 1] = docConceptInner;

													}
													if (!String.IsNullOrEmpty(orderstr) && Int32.TryParse(orderstr, out ordernum))
													{
														// before V11.6 -- for compatibility
														while (rows.Count < ordernum)
														{
															rows.Add(null);
															usages.Add(null);
														}

														rows[ordernum - 1] = docItemInner;
														usages[ordernum - 1] = docConceptInner;

														// migrate for next time
														docItemInner.Order = ordernum;
													}
													else
													{
														// manually generated without order defined -- add to end
														rows.Add(docItemInner);
														usages.Add(docConceptInner);
													}
												}
											}
										}
									}
								}

								if (rows.Count > 0)
								{
									sb.Append("<table class=\"gridtable\"><tr>");
									sb.Append("<th>Template</th>");
									foreach (string colname in cols)
									{
										sb.Append("<th>");
										sb.Append(colname);
										sb.Append("</th>");
									}
									sb.AppendLine("</tr>");

									for (int iSubRow = 0; iSubRow < rows.Count; iSubRow++)
									{
										DocTemplateItem docItem = rows[iSubRow];
										DocTemplateUsage docUsage = usages[iSubRow];

										//todo: show template with link... define icon at template...
										if (docItem != null)
										{
											sb.Append("<tr>");
											sb.Append("<td><a href=\"../../templates/");
											sb.Append(MakeLinkName(docUsage.Definition));
											sb.Append(".html\">");
											sb.Append(docUsage.Definition.Name);
											sb.Append("</a></td>");
											foreach (string colname in cols)
											{
												string pval = docItem.GetParameterValue(colname);
												pval = FormatField(docProject, pval, pval, pval, pval);

												sb.Append("<td>");
												sb.Append(pval);
												sb.Append("</td>");
											}
											sb.AppendLine("</tr>");
										}
									}

									sb.Append("</table>");
								}
							}

							if (docTemplateInner == null && value != null && mapSchema.TryGetValue(value, out schema))
							{
								sb.Append("<a href=\"../../");
								sb.Append(schema.ToLower());
								sb.Append("/lexical/");
								sb.Append(value.ToLower());
								sb.Append(".html\">");
								sb.Append(value);
								sb.Append("</a>");
							}
							else if (value != null)
							{
								sb.Append(value);
							}
						}
						else if (docDef != null && value != null)
						{
							value = FormatField(docProject, value, value, docDef.Name, value);
							sb.Append(value);
						}
						else if (value != null)
						{
							sb.Append(value);
						}
						else
						{
							sb.Append("&nbsp;");
						}

						sb.Append("</td>");
					}

					if (showdescriptions)
					{
						sb.Append("<td>");
						if (item.Documentation != null)
						{
							sb.Append(item.DocumentationHtmlNoParagraphs());
						}
						else
						{
							sb.Append("&nbsp;");
						}
						sb.Append("</td>");
					}

					sb.AppendLine("</tr>");
				}

				sb.AppendLine("</table>");
			}
			return sb.ToString();
		}

		public static string FormatReference(DocProject docProject, string value)
		{
			if (value == null)
				return null;

			StringBuilder sb = new StringBuilder();
			string[] parts = value.Split(new char[] { '\\' }, StringSplitOptions.RemoveEmptyEntries);
			foreach (string part in parts)
			{
				string[] tokens = part.Split('.');
				if (tokens.Length > 0)
				{
					sb.Append("\\");

					DocDefinition docToken = docProject.GetDefinition(tokens[0]);
					if (docToken != null)
					{
						DocSchema docSchema = docProject.GetSchemaOfDefinition(docToken);
						string relative = @"../../";
						string hyperlink = relative + docSchema.Name.ToLower() + @"/lexical/" + docToken.Name.ToLower() + ".html";
						string format = "<a href=\"" + hyperlink + "\">" + tokens[0] + "</a>";
						sb.Append(format);
					}

					if (tokens.Length > 1)
					{
						sb.Append(".");

						DocPropertySet docPset = null;
						DocQuantitySet docQset = null;
						DocSchema docSchema = null;
						string suffix = tokens[1];
						if (suffix.StartsWith("IsDefinedBy[") || suffix.StartsWith("HasProperties[")) // for IfcMaterialProperties
						{
							int bracketopen = suffix.IndexOf('[') + 2;
							int bracketclose = suffix.IndexOf(']') - 1;
							if (bracketclose - bracketopen > 0)
							{
								string psetname = suffix.Substring(bracketopen, bracketclose - bracketopen);

								docPset = docProject.FindPropertySet(psetname, out docSchema);
								if (docPset == null)
								{
									docQset = docProject.FindQuantitySet(psetname, out docSchema);
								}
							}
						}

						if (docPset != null)
						{
							sb.Append("IsDefinedBy['<a href=\"../../" + docSchema.Name.ToLower() + "/pset/" + docPset.Name.ToLower() + ".html\">" + docPset.Name + "</a>']");
						}
						else if (docQset != null)
						{
							sb.Append("IsDefinedBy['<a href=\"../../" + docSchema.Name.ToLower() + "/qset/" + docQset.Name.ToLower() + ".html\">" + docQset.Name + "</a>']");
						}
						else
						{
							sb.Append(suffix);
						}
					}

					sb.Append("<br>");
				}
			}

			return sb.ToString();
		}

		/// <summary>
		/// Formats a template given an entity and optional template
		/// </summary>
		/// <param name="entity">The entity to format.</param>
		/// <param name="usage">Use definition to format, or null for all use definitions for entity.</param>
		/// <param name="iFigure">The last figure number used.</param>
		/// /// <param name="iFigure">The last table number used.</param>
		/// <returns></returns>
		private static string FormatConcept(
			DocProject docProject,
			DocEntity entity,
			DocModelView docModelView,
			DocConceptRoot root,
			DocTemplateUsage usage,
			string usageDocumentation,
			Dictionary<string, DocObject> mapEntity,
			Dictionary<string, string> mapSchema,
			List<ContentRef> listFigures,
			List<ContentRef> listTables,
			string path,
			DocPublication docPublication)
		{
			if (usage.Definition == null)
				return String.Empty;

			StringBuilder sb = new StringBuilder();

			string anchorid = MakeLinkName(usage.Definition);

			// anchor
			sb.Append("<a id=\"");
			sb.Append(anchorid);
			sb.Append("\" />");
			sb.AppendLine();

			string conceptcaption = usage.Name;
			if (String.IsNullOrEmpty(conceptcaption))
			{
				conceptcaption = usage.Definition.Name;
			}

			// Caption       
			if (docPublication.ISO)
			{
				sb.Append("<p><b><u>");
				sb.Append(conceptcaption);
				sb.Append("</u></b></p>");
				sb.AppendLine();
			}
			else
			{
				sb.Append("<p class=\"use-head\">");
				sb.Append(conceptcaption);
				sb.Append("</p>");
				sb.AppendLine();
			}

			// new (2.0): capture inherited properties too
			DocTemplateItem[] listItems = FindTemplateItems(docProject, entity, usage.Definition, docModelView);

			// add stock sentence

			// typical values: "Material Constituents", "Documents", "Aggregation", "Nesting", "Representations"
			// Usage of the <i>Material Constituents</i> concept is shown in Table XXXX.
			// Usage of the <i>Nesting</i> concept is shown in Table XXXX.
			// Usage of the <i>Aggregation</i> concept is shown in Table XXXX:

			// get link of usage
			string deflink = MakeLinkName(usage.Definition) + ".html";

			if (listItems.Length > 0)
			{
				listTables.Add(new ContentRef(entity.Name + " " + usage.Definition.Name, entity));

				sb.Append("<p>The <a href=\"../../templates/");
				sb.Append(deflink);
				sb.Append("\">");
				sb.Append(usage.Definition.Name);
				sb.Append("</a> concept template applies to this entity as shown in Table ");
				sb.Append(listTables.Count);
				sb.Append(".");

				sb.AppendLine("<table>");
				sb.AppendLine("<tr><td>");

				string table = FormatConceptTable(docProject, docModelView, entity, root, usage, mapEntity, mapSchema);
				sb.Append(table);

				sb.AppendLine("</td></tr>");
				sb.Append("<tr><td><p class=\"table\">Table ");
				sb.Append(listTables.Count);
				sb.Append(" &mdash; ");
				sb.Append(entity.Name);
				sb.Append(" ");
				sb.Append(usage.Definition.Name);
				sb.AppendLine("</td></tr></table>");
				sb.AppendLine();
			}
			else
			{
				sb.Append("<p>The <a href=\"../../templates/");
				sb.Append(deflink);
				sb.Append("\">");
				sb.Append(usage.Definition.Name);

				if (usage.Suppress)
				{
					sb.Append("</a> concept (defined at a supertype) does NOT apply to this entity.</p>");
				}
				else if (usage.Override)
				{
					sb.Append("</a> concept applies to this entity, and overrides usage indicated at supertypes.</p>");
				}
				else
				{
					sb.Append("</a> concept applies to this entity.</p>");
				}
			}

			// add figure if it exists
			string fig = FormatFigure(docProject, entity, usage.Definition, entity.Text, listFigures, path);
			if (fig != null)
			{
				sb.Append(fig);
			}

			if (usage.Documentation != null)
			{
				sb.AppendLine(usageDocumentation); // special case if definition provides description, such as for classification
			}

			if (docPublication.Exchanges)
			{
				string req = FormatRequirements(usage, docModelView, true);
				if (req != null)
				{
					sb.AppendLine(req);
				}
			}

			sb.AppendLine("<br/><br/>");

			return sb.ToString();
		}

		private static string FormatField(DocProject docProject, string content /*deprecate*/, string fieldname, string fieldtype/*deprecate*/, string fieldvalue/*deprecate*/)
		{
			DocDefinition docDef = docProject.GetDefinition(fieldname);

			// hyperlink to enumerators
			if (docDef is DocEnumeration)
			{
				// hyperlink to enumeration definition

				// replace it with hyperlink
				DocSchema docSchema = docProject.GetSchemaOfDefinition(docDef);
				string relative = @"../../";
				string hyperlink = relative + docSchema.Name.ToLower() + @"/lexical/" + docDef.Name.ToLower() + ".html";
				string format = "<a href=\"" + hyperlink + "\">" + fieldvalue + "</a>";

				return format;// content.Replace(fieldname, format);
			}
			else if (docDef is DocEntity || docDef is DocType)//fieldvalue != null && fieldvalue.StartsWith("Ifc") && docProject.GetDefinition(fieldvalue) != null)
			{
				// replace it with hyperlink
				DocSchema docSchema = docProject.GetSchemaOfDefinition(docDef);
				string relative = @"../../";
				string hyperlink = relative + docSchema.Name.ToLower() + @"/lexical/" + docDef.Name.ToLower() + ".html";
				string format = "<a href=\"" + hyperlink + "\">" + fieldvalue + "</a>";

				return format;// content.Replace(fieldname, format);
			}
			else //if (docDef == null)
			{
				// hyperlink to property set definition
				DocSchema docSchema = null;
				DocObject docObj = docProject.FindPropertySet(fieldvalue, out docSchema);
				if (docObj is DocPropertySet)
				{
					string relative = @"../../";
					string hyperlink = relative + docSchema.Name.ToLowerInvariant() + @"/pset/" + docObj.Name.ToLower() + ".html"; // case-sensitive on linux -- need to make schema all lowercase
					string format = "<a href=\"" + hyperlink + "\">" + fieldvalue + "</a>";
					return format;// content.Replace(fieldname, format);
				}
				else
				{
					docObj = docProject.FindPropertyEnumeration(fieldvalue);
					if (docObj is DocPropertyEnumeration)
					{
						string relative = @"../../../";
						string hyperlink = relative + @"/penum/" + docObj.Name.ToLower() + ".html";
						string format = "<a href=\"" + hyperlink + "\">" + fieldvalue + "</a>";
						return format;
					}
					else
					{
						docObj = docProject.FindQuantitySet(fieldvalue, out docSchema);
						if (docObj is DocQuantitySet)
						{
							string relative = @"../../";
							string hyperlink = relative + docSchema.Name.ToLowerInvariant() + @"/qset/" + docObj.Name.ToLower() + ".html"; // case-sentive on linux -- need to make schema all lowercase
							string format = "<a href=\"" + hyperlink + "\">" + fieldvalue + "</a>";
							return format;
						}

					}
				}

				if (docObj == null)
				{
					return fieldvalue;
				}
			}

			return content;
		}

		private static void GenerateExample(
			DocProject docProject,
			DocPublication docPublication,
			DocExample docExample,
			List<DocXsdFormat> listFormats,
			string path,
			List<int> indexpath,
			Dictionary<DocObject, bool> included,
			Dictionary<string, DocObject> mapEntity,
			Dictionary<string, string> mapSchema,
			List<ContentRef> listFigures,
			List<ContentRef> listTables,
			FormatHTM htmTOC,
			FormatHTM htmSectionTOC,
			Dictionary<DocFormatSchemaEnum, Serializer> mapFormats,
			Dictionary<long, object> outerinstancemap, // instance data of parent example, if inherited
			object outerinstanceroot
			)
		{
			if (included == null || included.ContainsKey(docExample))
			{
				indexpath[indexpath.Count - 1]++;

				StringBuilder indexpathname = new StringBuilder();
				indexpathname.Append("E");
				foreach (int x in indexpath)
				{
					indexpathname.Append(".");
					indexpathname.Append(x);
				}
				string indexpathstring = indexpathname.ToString();

				string htmlpreview = String.Empty;


				string pathExample = path + @"\annex\annex-e\" + MakeLinkName(docExample) + ".html";
				string urlExample = "annex-e/" + MakeLinkName(docExample) + ".html";
				htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"annex/" + urlExample + "\" >" + indexpathstring + " " + docExample.Name + "</a>");

				string linkid = "";
				if (indexpath.Count == 1)
				{
					linkid = indexpath[0].ToString();
				}
				string htmllink = "<a class=\"listing-link\" id=\"" + linkid + "\" href=\"" + urlExample + "\" target=\"info\">" + docExample.Name + "</a>";
				htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">" + indexpathstring + " " + htmllink + "</td></tr>");

				using (FormatHTM htmExample = new FormatHTM(pathExample, mapEntity, mapSchema, included))
				{
					htmExample.WriteHeader(docExample.Name, 2, docPublication.Header);
					htmExample.WriteScript(-5, indexpath[0], 0, 0);
					htmExample.WriteLine("<h3 class=\"std\">" + indexpathstring + " " + docExample.Name + "</h3>");

					// extract file
					byte[] filecontents = docExample.File;
					if (filecontents == null && docExample.Path != null)// && !String.IsNullOrEmpty(Properties.Settings.Default.ConverterPath))
					{
						try
						{
							// generate IFC file, read it
							if (System.IO.File.Exists(Properties.Settings.Default.ConverterPath))
							{
								string outputpath = System.IO.Path.GetDirectoryName(docExample.Path) + @"\" + System.IO.Path.GetFileNameWithoutExtension(docExample.Path) + ".ifc";

								// execute
								System.Diagnostics.Process proc = System.Diagnostics.Process.Start(Properties.Settings.Default.ConverterPath, "-i " + docExample.Path);
								proc.WaitForExit();

								// now read the file
								if (System.IO.File.Exists(outputpath))
								{
									filecontents = System.IO.File.ReadAllBytes(outputpath);

									string previewpath = "./" + docExample.Name.Replace("_", "") + "/index.html";
									htmlpreview = "<a href=\"" + previewpath + "\"><img src=\"../../img/diagram.png\" style=\"border: 0px\" title=\"Preview\" alt=\"Preview\"/>&nbsp; Preview</a>";
								}
								else
								{
									System.Diagnostics.Debug.WriteLine("IfcDoc: missing example file: " + outputpath);
								}
							}
							else if (System.IO.File.Exists(docExample.Path))
							{
								filecontents = System.IO.File.ReadAllBytes(docExample.Path);
							}
						}
						catch
						{
						}
					}

					// table of files
					if (filecontents != null)
					{
						htmExample.Write("<table class=\"gridtable\">");
						htmExample.Write("<tr><th>Format</th><th>ASCII</th>");
						if (docPublication.HtmlExamples)
						{
							htmExample.Write("<th>HTML</th>");
						}
						htmExample.Write("<th>Size</th></tr>");


						if (filecontents != null && filecontents.Length > 0 && !Properties.Settings.Default.SkipDiagrams)
						{
							string pathIFC = path + @"\annex\annex-e\" + MakeLinkName(docExample) + ".ifc";

							using (System.IO.FileStream filestream = new System.IO.FileStream(pathIFC, System.IO.FileMode.Create, System.IO.FileAccess.Write, System.IO.FileShare.Read))
							{
								filestream.Write(filecontents, 0, filecontents.Length);
							}

							using (Stream memstream = new MemoryStream(filecontents, false))
							{
								StepSerializer spfExample = (StepSerializer)mapFormats[DocFormatSchemaEnum.STEP];
								outerinstanceroot = spfExample.ReadObject(memstream, out outerinstancemap);
								if (outerinstanceroot != null)
								{
									string pathListing = path + @"\annex\annex-e\" + MakeLinkName(docExample) + ".ifc.html";

									foreach (DocFormat docFormat in docPublication.Formats)
									{
										// generate example in other formats...
										if (docFormat.FormatOptions == DocFormatOptionEnum.Examples && docFormat.FormatType != DocFormatSchemaEnum.SQL)
										{
											long filesize = filecontents.LongLength;

											Serializer formatext = null;
											if (mapFormats.TryGetValue(docFormat.FormatType, out formatext))
											{
												string pathRAW = path + @"\annex\annex-e\" + MakeLinkName(docExample) + "." + docFormat.ExtensionInstances;
											
												using (Stream stream = new FileStream(pathRAW, FileMode.Create))
												{
													try
													{
														if (docFormat.FormatType == DocFormatSchemaEnum.XML)
														{
															XmlHeader header = new XmlHeader();
															header.preprocessor_version = "buildingSMART IfcKit";
															System.Reflection.AssemblyName assembly = System.Reflection.Assembly.GetExecutingAssembly().GetName();
															header.originating_system = assembly.Name + " v" + assembly.Version.ToString();
															XmlElementIfc xmlElementIfc = new XmlElementIfc(header);
															xmlElementIfc.Add(outerinstanceroot);
															formatext.WriteObject(stream, xmlElementIfc);
														}
														else
															formatext.WriteObject(stream, outerinstanceroot);
													}
													catch (Exception xxx)
													{
														xxx.ToString();
													}
													stream.Flush();
													filesize = stream.Length;

													if (docPublication.HtmlExamples)
													{
														// markup output with hyperlinks
														string pathHTM = pathRAW + ".html";
														using (FormatHTM fmtHTM = new FormatHTM(pathHTM, mapEntity, mapSchema, included))
														{
															stream.Position = 0;
															StreamReader reader = new StreamReader(stream);
															string sourcecontent = reader.ReadToEnd();

															fmtHTM.WriteHeader(docExample.Name, 2, docPublication.Header);
															fmtHTM.WriteExpression(sourcecontent, "../../schema/");
															fmtHTM.WriteFooter("");
														}
													}
												}
											}

											string sizetext = filesize.ToString();
											string ext = docFormat.ExtensionInstances;
											htmExample.WriteLine("<tr><td>" + docFormat.FormatType.ToString() + "</td><td><a href=\"" + MakeLinkName(docExample) + "." + ext + "\" target=\"_blank\">File</a></td>");
											if (docPublication.HtmlExamples)
											{
												htmExample.WriteLine("<td><a href=\"" + MakeLinkName(docExample) + "." + ext + ".html\" target=\"_blank\">Markup</a></td>");
											}
											htmExample.WriteLine("<td style=\"text-align:right\">" + sizetext + "</td></tr>");
										}
									}
								}
							}

						}

						htmExample.Write("</table>");

						htmExample.WriteLine(htmlpreview);

						htmExample.Write("<table class=\"gridtable\">");
						htmExample.Write("<tr><th>View</th></tr>");
						foreach (DocModelView docView in docExample.Views)
						{
							if (included != null && included.ContainsKey(docView))
							{
								string hyperlink = "../../schema/views/" + MakeLinkName(docView) + "/index.html";
								htmExample.Write("<tr><td><a href=\"" + hyperlink + "\">" + docView.Name + "</td></tr>");
							}
						}
						htmExample.Write("</table>");

						if (docExample.ApplicableType != null)
						{
							string[] ApplicableTypesArray = docExample.ApplicableType.Split(',');
							htmExample.Write("<table class=\"gridtable\">");
							htmExample.Write("<tr><th>Entity</th></tr>");
							for (int i = 0; i < ApplicableTypesArray.Length; i++)
							{
								string hyperlink = "../../schema/" + mapSchema[ApplicableTypesArray.GetValue(i).ToString()].ToString().ToLower() + "/lexical/" + ApplicableTypesArray.GetValue(i).ToString().ToLower() + ".html";
								htmExample.Write("<tr><td><a href=" + hyperlink + ">" + ApplicableTypesArray.GetValue(i) + "</td></tr>");
							}
							htmExample.Write("</table>");
						}
					}

					string documentation = UpdateNumbering(docExample.DocumentationHtml(), listFigures, listTables, docExample);

					htmExample.WriteDocumentationMarkup(documentation, docExample, docPublication, path);

					// generate tables --- if option selected...
					if (docPublication.GetFormatOption(DocFormatSchemaEnum.SQL) == DocFormatOptionEnum.Examples)
					{
						GenerateExampleExchange(docProject, docPublication, docExample, null, path, indexpath, mapEntity, mapSchema, included, outerinstancemap, outerinstanceroot, htmSectionTOC);
					}
#if false
                    if (filecontents == null && outerinstancemap != null && docExample.Views.Count > 0)
                    {
                        // if specific to exchange, capture inline
                        // hack for now based on example name matching exchange name -- make explicit later
                        foreach (DocExchangeDefinition docExchange in docExample.Views[0].Exchanges)
                        {
                            if (docExample.Name.Equals(docExchange.Name))
                            {
                                GenerateExampleExchange(docProject, docPublication, docExample, docExchange, path, indexpath, mapEntity, mapSchema, included, outerinstancemap, outerinstanceroot, htmSectionTOC);
                                break;
                            }
                        }
                    }
                    else if (filecontents != null && docExample.Examples.Count == 0 && outerinstancemap != null && docExample.Views.Count > 0)
                    {
                        DocExchangeDefinition docExchange = null; // use all exchanges

                        foreach (DocExchangeDefinition docEachExchange in docExample.Views[0].Exchanges)
                        {
                            if (docExample.Name.Equals(docEachExchange.Name))
                            {
                                docExchange = docEachExchange;
                                break;
                            }
                        }

                        GenerateExampleExchange(docProject, docPublication, docExample, docExchange, path, indexpath, mapEntity, mapSchema, included, outerinstancemap, outerinstanceroot, htmSectionTOC);
                    }
#endif

					htmExample.WriteLinkTo(docProject, docPublication, docExample);
					htmExample.WriteFooter(docPublication.Footer);
				}

				using (FormatHTM htmLink = new FormatHTM(path + "/link/" + MakeLinkName(docExample) + ".html", mapEntity, mapSchema, included))
				{
					string linkurl = "../annex/annex-e/" + MakeLinkName(docExample) + ".html";
					htmLink.WriteLinkPage(linkurl, docPublication);
				}

				if (docExample.Examples.Count > 0)
				{
					indexpath.Add(0);
					foreach (DocExample docSub in docExample.Examples)
					{
						try
						{
							GenerateExample(docProject, docPublication, docSub, listFormats, path, indexpath, included, mapEntity, mapSchema, listFigures, listTables, htmTOC, htmSectionTOC, mapFormats, outerinstancemap, outerinstanceroot);
						}
						catch(Exception x)
						{
							System.Diagnostics.Debug.WriteLine(x.Message + " - " + x.StackTrace);
						}
					}
					indexpath.RemoveAt(indexpath.Count - 1);
				}
			}

		}

		/// <summary>
		/// Generates example exchange-specific information -- tables based on mappings
		/// </summary>
		private static void GenerateExampleExchange(DocProject docProject, DocPublication docPublication, DocExample docExample, DocExchangeDefinition docExchange,
			string path, List<int> indexpath, Dictionary<string, DocObject> mapEntity, Dictionary<string, string> mapSchema, Dictionary<DocObject, bool> mapIncluded,
			Dictionary<long, object> instances, object root, FormatHTM htmSectionTOC)
		{
			if (instances == null)
				return;

			indexpath.Add(0);

			foreach (DocModelView docView in docExample.Views)
			{
				// V12.0
				foreach (DocConceptRoot docRoot in docView.ConceptRoots)
				{
					string pathExample = path + @"\annex\annex-e\" + MakeLinkName(docExample) + @"\" + MakeLinkName(docRoot) + ".html";
					string urlExample = "annex-e/" + MakeLinkName(docExample) + "/" + MakeLinkName(docRoot) + ".html";

					indexpath[indexpath.Count - 1]++;

					StringBuilder indexpathname = new StringBuilder();
					indexpathname.Append("E");
					foreach (int x in indexpath)
					{
						indexpathname.Append(".");
						indexpathname.Append(x);
					}
					string indexpathstring = indexpathname.ToString();


					using (FormatHTM htmExample = new FormatHTM(pathExample, mapEntity, mapSchema, mapIncluded))
					{
						htmExample.WriteHeader(docExample.Name, 3, docPublication.Header);
						htmExample.WriteScript(-5, indexpath[0], indexpath[1], 0);
						htmExample.WriteLine("<h3 class=\"std\">" + indexpathstring + " " + docRoot.Name + "</h3>");

						StringBuilder sb = new StringBuilder();
						sb.AppendLine("<table class=\"gridtable\">");
						List<string> colstyles = new List<string>();
						List<string> colformat = new List<string>();
						List<CvtValuePath> colmaps = new List<CvtValuePath>();

						// generate header row
						sb.AppendLine("<tr>");
						foreach (DocTemplateUsage docItem in docRoot.Concepts)
						{
							string name = docItem.Name;
							string disp = null;//"#" + docItem.GetColor().ToArgb().ToString("X8");
							string form = null;//docItem.GetParameterValue("Format");

							string style = "";
							if (!String.IsNullOrEmpty(disp))
							{
								style = " style=\"background-color:" + disp + ";\"";
							}
							colstyles.Add(style);

							string format = "";
							if (!String.IsNullOrEmpty(form))
							{
								format = form;
							}
							colformat.Add(format);

							string desc = "";
							CvtValuePath valpath = CvtValuePath.FromTemplateDefinition(docItem.Definition, docProject);
							colmaps.Add(valpath);
							if (valpath != null)
							{
								desc = valpath.ToString().Replace("\\", "&#10;");
							}

							sb.Append("<th title=\"" + desc + "\">");//<a href=\"../../schema/views/" + DocumentationISO.MakeLinkName(docView) + "/" + DocumentationISO.MakeLinkName(docExchange) + ".html#" + DocumentationISO.MakeLinkName(docConcept) + "\" title=\"" + desc + "\">");
							sb.Append(name);
							sb.Append("</th>");
						};
						sb.AppendLine("</tr>");

						// generate data rows
						List<DocModelRule> trace = new List<DocModelRule>();


						CvtValuePath valpathQuery = null;
						if (docRoot.ApplicableTemplate != null)
						{
							valpathQuery = CvtValuePath.FromTemplateDefinition(docRoot.ApplicableTemplate, docProject);
						}

						int count = 0;
						foreach (object e in instances.Values)
						{
							string eachname = e.GetType().Name;
							if (docRoot.ApplicableEntity.IsInstanceOfType(e))
							{
								bool includerow = true;

								// check against query
								if (valpathQuery != null)
								{
									object val = valpathQuery.GetValue(e, null);
									if (val == null)
										includerow = false;
								}

								if (includerow)
								{
									count++;
									if (count > 1000)
									{
										//...sb.Append("<tr><td colspan=\"" + listItems.Count + "\">...</td></tr>");
										break; // max exceeded
									}

									StringBuilder sbRow = new StringBuilder();

									sbRow.Append("<tr>");
									int iCol = 0;
									foreach (DocTemplateUsage docItem in docRoot.Concepts)
									{
										sbRow.Append("<td" + colstyles[iCol]);
										CvtValuePath valpath = colmaps[iCol];
										string format = colformat[iCol];

										iCol++;

										if (docItem.Name.Contains("Character"))
										{
											docItem.ToString();
										}

										if (valpath != null)
										{
											//...

											string nn = docItem.Name;
											object value = valpath.GetValue(e, null);

											// special case for properties
											if (value == null &&
												valpath.Property != null && valpath.Property.Name == "IsDefinedBy" &&
												valpath.Identifier != null &&
												valpath.InnerPath != null &&
												valpath.InnerPath.InnerPath != null && valpath.InnerPath.InnerPath.Identifier != null &&
												valpath.InnerPath.InnerPath.InnerPath != null)
											{
												string pset = valpath.Identifier;
												string prop = valpath.InnerPath.InnerPath.Identifier;
												string suff = valpath.InnerPath.InnerPath.InnerPath.ToString();
												CvtValuePath valpathtype = CvtValuePath.Parse(@"\" + valpath.Type + @".IsTypedBy\IfcRelDefinesByType.RelatingType\IfcTypeObject.HasPropertySets['" + pset + @"']\IfcPropertySet.HasProperties['" + prop + "']" + suff, mapEntity);
												if (valpathtype != null)
												{
													value = valpathtype.GetValue(e, null);

													if (value != null)
													{
														value.ToString();
													}
												}
											}

											if (value == e)
											{
												value = e.GetType().Name;
											}
											else if (CvtValuePath.IsEntity(value))
											{
												// special case for time series
												if (value.GetType().Name.Equals("IfcIrregularTimeSeries"))
												{
													System.Reflection.FieldInfo fieldValue = value.GetType().GetField("Values");
													if (fieldValue != null)
													{
														System.Collections.IList list = (System.Collections.IList)fieldValue.GetValue(value);

														if (list.Count > 0)
														{
															object elem = list[0];

															System.Reflection.FieldInfo fieldTSV = elem.GetType().GetField("ListValues");
															if (fieldTSV != null)
															{
																System.Collections.IList lv = (System.Collections.IList)fieldTSV.GetValue(elem);
																if (lv.Count > 0)
																{
																	System.Reflection.FieldInfo fn = lv[0].GetType().GetField("Value");
																	if (fn != null)
																	{
																		string vstr = fn.GetValue(lv[0]).ToString();
																		value = "Time Series[" + list.Count + "] {" + lv[0].GetType().Name + "(" + vstr + ")}";

																		System.Diagnostics.Debug.WriteLine(valpath.ToString() + " - " + value);
																	}
																}
															}

														}
													}
												}
												else
												{
													// use name
													System.Reflection.FieldInfo fieldValue = value.GetType().GetField("Name");
													if (fieldValue != null)
													{
														value = fieldValue.GetValue(value);
													}
												}
											}
											else if (value is System.Collections.IEnumerable)
											{
												System.Collections.IEnumerable list = (System.Collections.IEnumerable)value;
												StringBuilder sbList = new StringBuilder();
												foreach (object elem in list)
												{
													System.Reflection.PropertyInfo fieldName = elem.GetType().GetProperty("Name");
													if (fieldName != null)
													{
														object elemname = fieldName.GetValue(elem);
														if (elemname != null)
														{
															System.Reflection.PropertyInfo fieldValue = elemname.GetType().GetProperty("Value");
															if (fieldValue != null)
															{
																object elemval = fieldValue.GetValue(elemname);
																sbList.Append(elemval.ToString());
															}
														}
													}
													sbList.Append("; <br/>");
												}
												value = sbList.ToString();
											}
											else if (value is Type)
											{
												value = ((Type)value).Name;
											}

											if (!String.IsNullOrEmpty(format))
											{
												if (format.Equals("Required") && value == null)
												{
													includerow = false; //  used for requiring classification for spaces
												}
											}

											if (value != null)
											{
												System.Reflection.PropertyInfo fieldValue = value.GetType().GetProperty("Value");
												while (fieldValue != null)
												{
													value = fieldValue.GetValue(value);
													fieldValue = value.GetType().GetProperty("Value");
												}

												if (format != null && format.Equals("True") && (value == null || !value.ToString().Equals("True")))
												{
													includerow = false; //  used for requiring exterior walls
												}

												if (value is Double)
												{
													sbRow.Append(" align=\"right\">");

													sbRow.Append(((Double)value).ToString("N3"));
												}
												else if (value is List<Int64>)
												{
													sbRow.Append(">");

													// latitude or longitude
													List<Int64> intlist = (List<Int64>)value;
													if (intlist.Count >= 3)
													{
														sbRow.Append(intlist[0] + "° " + intlist[1] + "' " + intlist[2] + "\"");
													}
												}
												else if (value != null)
												{
													sbRow.Append(">");
													sbRow.Append(value.ToString()); // todo: html-encode
												}
											}
											else
											{
												sbRow.Append(">");
												sbRow.Append("&nbsp;");
											}
										}
										else
										{
											sbRow.Append(">");
										}

										sbRow.Append("</td>");
									}
									sbRow.AppendLine("</tr>");

									if (includerow)
									{
										sb.Append(sbRow.ToString());
									}
								}
							}
						}

						sb.AppendLine("</table>");
						sb.AppendLine("<br/>");

						htmExample.Write(sb.ToString());



						//htmExample.WriteLine(dataconcept);

						htmExample.WriteFooter(docPublication.Footer);
					}

					string linkid = indexpath[0].ToString();//??
					string htmllink = "<a class=\"listing-link\" id=\"" + linkid + "\" href=\"" + urlExample + "\" target=\"info\">" + docRoot.Name + "</a>";
					htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">" + indexpathstring + " " + htmllink + "</td></tr>");

					// also populate contents on left
					//...

				}
			}
#if false
            // new: show multiple views
            foreach (DocSection docSection in docProject.Sections)
            {
                foreach (DocSchema docSchema in docSection.Schemas)
                {
                    foreach (DocEntity docEntity in docSchema.Entities)
                    {
                        // track the first unique item using a mapping
                        List<DocTemplateItem> listItems = new List<DocTemplateItem>();
                        List<DocTemplateUsage> listUsage = new List<DocTemplateUsage>();

                        // correlate first item with exchanges that include item and any related ones
                        Dictionary<DocTemplateItem, List<DocModelView>> mapView = new Dictionary<DocTemplateItem, List<DocModelView>>();

                        // keep track of concept roots -- used for filtering...
                        List<DocConceptRoot> listRoots = new List<DocConceptRoot>();

                        foreach (DocModelView docEachView in listView)
                        {
                            foreach (DocConceptRoot docRoot in docEachView.ConceptRoots)
                            {
                                if (docRoot.ApplicableEntity == docEntity && !docRoot.IsDeprecated())
                                {
                                    foreach (DocTemplateUsage docConcept in docRoot.Concepts)
                                    {
                                        //...

                                        if (docConcept.Definition != null && docConcept.Definition.Uuid == DocTemplateDefinition.guidTemplateMapping)
                                        {
                                            foreach (DocTemplateItem docItem in docConcept.Items)
                                            {
                                                string refItem = docItem.GetParameterValue("Reference");

                                                // is it already define?
                                                bool add = true;
                                                foreach (DocTemplateItem docExist in listItems)
                                                {
                                                    string refExist = docExist.GetParameterValue("Reference");
                                                    if (refItem == refExist)
                                                    {
                                                        // already there
                                                        add = false;
                                                        if (!mapView.ContainsKey(docExist))
                                                        {
                                                            mapView.Add(docExist, new List<DocModelView>());
                                                        }
                                                        mapView[docExist].Add(docEachView);

                                                        break;
                                                    }
                                                }

                                                if (add)
                                                {
                                                    listItems.Add(docItem);
                                                    listUsage.Add(docConcept);

                                                    if (!mapView.ContainsKey(docItem))
                                                    {
                                                        mapView.Add(docItem, new List<DocModelView>());
                                                    }
                                                    mapView[docItem].Add(docEachView);

                                                    if(!listRoots.Contains(docRoot))
                                                    {
                                                        listRoots.Add(docRoot);
                                                    }
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }

                        if (listItems.Count > 0)
                        {
                            // generate page for entity

                            string pathExample = path + @"\annex\annex-e\" + MakeLinkName(docExample) + @"\" + MakeLinkName(docEntity) + ".html";
                            string urlExample = "annex-e/" + MakeLinkName(docExample) + "/" + MakeLinkName(docEntity) + ".html";

                            indexpath[indexpath.Count - 1]++;

                            StringBuilder indexpathname = new StringBuilder();
                            indexpathname.Append("E");
                            foreach (int x in indexpath)
                            {
                                indexpathname.Append(".");
                                indexpathname.Append(x);
                            }
                            string indexpathstring = indexpathname.ToString();


                            using (FormatHTM htmExample = new FormatHTM(pathExample, mapEntity, mapSchema, mapIncluded))
                            {
                                htmExample.WriteHeader(docExample.Name, 3, docPublication.Header);
                                htmExample.WriteScript(-5, indexpath[0], indexpath[1], 0);
                                htmExample.WriteLine("<h3 class=\"std\">" + indexpathstring + " " + docEntity + "</h3>");

                                StringBuilder sb = new StringBuilder();
                                sb.AppendLine("<table class=\"gridtable\">");
                                List<string> colstyles = new List<string>();
                                List<string> colformat = new List<string>();
                                List<CvtValuePath> colmaps = new List<CvtValuePath>();

                                // generate header row
                                sb.AppendLine("<tr>");
                                foreach (DocTemplateItem docItem in listItems)
                                {
                                    string name = docItem.GetParameterValue("Name");
                                    string disp = "#" + docItem.GetColor().ToArgb().ToString("X8");
                                    string expr = docItem.GetParameterValue("Reference");
                                    string form = docItem.GetParameterValue("Format");

                                    string style = "";
                                    if (!String.IsNullOrEmpty(disp))
                                    {
                                        style = " style=\"background-color:" + disp + ";\"";
                                    }
                                    colstyles.Add(style);

                                    string format = "";
                                    if (!String.IsNullOrEmpty(form))
                                    {
                                        format = form;
                                    }
                                    colformat.Add(format);

                                    string desc = "";
                                    CvtValuePath valpath = CvtValuePath.Parse(expr, mapEntity); //todo: move out of loop
                                    colmaps.Add(valpath);
                                    if (valpath != null)
                                    {
                                        desc = valpath.ToString().Replace("\\", "&#10;");
                                    }

                                    sb.Append("<th title=\"" + desc + "\">");//<a href=\"../../schema/views/" + DocumentationISO.MakeLinkName(docView) + "/" + DocumentationISO.MakeLinkName(docExchange) + ".html#" + DocumentationISO.MakeLinkName(docConcept) + "\" title=\"" + desc + "\">");
                                    sb.Append(name);
                                    sb.Append("</th>");
                                };
                                sb.AppendLine("</tr>");

                                // generate data rows
                                List<DocModelRule> trace = new List<DocModelRule>();

                                int count = 0;
                                foreach (SEntity e in instances.Values)
                                {
                                    string eachname = e.GetType().Name;
                                    if (docEntity.IsInstanceOfType(e))
                                    {
                                        bool includerow = true;

#if false // later...
                                        foreach (DocConceptRoot docRoot in listRoots)
                                        {
                                            // if root has more complex rules, check them
                                            if (docRoot.ApplicableTemplate != null && docRoot.ApplicableItems.Count > 0)
                                            {
                                                includerow = false;

                                                // must check1
                                                foreach (DocTemplateItem docItem in docRoot.ApplicableItems)
                                                {
                                                    foreach (DocModelRule rule in docRoot.ApplicableTemplate.Rules)
                                                    {
                                                        try
                                                        {
                                                            trace.Clear();
                                                            bool? result = rule.Validate(e, docItem, typemap, trace, e, null, null);
                                                            if (result == true && docRoot.ApplicableOperator == DocTemplateOperator.Or)
                                                            {
                                                                includerow = true;
                                                                break;
                                                            }
                                                        }
                                                        catch
                                                        {
                                                            docRoot.ToString();
                                                        }
                                                    }

                                                    // don't yet support AND or other operators

                                                    if (includerow)
                                                        break;
                                                }
                                            }
                                        }
#endif


                                        if (includerow)
                                        {
                                            count++;
                                            if (count > 1000)
                                            {
                                                sb.Append("<tr><td colspan=\"" + listItems.Count + "\">...</td></tr>");
                                                break; // max exceeded
                                            }

                                            StringBuilder sbRow = new StringBuilder();

                                            sbRow.Append("<tr>");
                                            int iCol = 0;
                                            foreach (DocTemplateItem docItem in listItems)
                                            {
                                                sbRow.Append("<td" + colstyles[iCol]);
                                                CvtValuePath valpath = colmaps[iCol];
                                                string format = colformat[iCol];

                                                iCol++;

                                                if (valpath != null)
                                                {
                                                    string nn = docItem.GetParameterValue("Name");
                                                    object value = valpath.GetValue(e, null);

                                                    // special case for properties
                                                    if (value == null &&
                                                        valpath.Property != null && valpath.Property.Name == "IsDefinedBy" &&
                                                        valpath.Identifier != null && 
                                                        valpath.InnerPath != null &&
                                                        valpath.InnerPath.InnerPath != null && valpath.InnerPath.InnerPath.Identifier != null &&
                                                        valpath.InnerPath.InnerPath.InnerPath != null)
                                                    {
                                                        string pset = valpath.Identifier;
                                                        string prop = valpath.InnerPath.InnerPath.Identifier;
                                                        string suff = valpath.InnerPath.InnerPath.InnerPath.ToString();
                                                        CvtValuePath valpathtype = CvtValuePath.Parse(@"\" + valpath.Type + @".IsTypedBy\IfcRelDefinesByType.RelatingType\IfcTypeObject.HasPropertySets['" + pset + @"']\IfcPropertySet.HasProperties['"+ prop +"']" + suff, mapEntity);
                                                        if(valpathtype != null)
                                                        {
                                                            value = valpathtype.GetValue(e, null);

                                                            if(value != null)
                                                            {
                                                                value.ToString();
                                                            }
                                                        }
                                                    }

                                                    if (value == e)
                                                    {
                                                        value = e.GetType().Name;
                                                    }
                                                    else if (value is SEntity)
                                                    {
                                                        // special case for time series
                                                        if (value.GetType().Name.Equals("IfcIrregularTimeSeries"))
                                                        {
                                                            System.Reflection.FieldInfo fieldValue = value.GetType().GetField("Values");
                                                            if(fieldValue != null)
                                                            {
                                                                System.Collections.IList list = (System.Collections.IList)fieldValue.GetValue(value);

                                                                if (list.Count > 0)
                                                                {
                                                                    object elem = list[0];

                                                                    System.Reflection.FieldInfo fieldTSV = elem.GetType().GetField("ListValues");
                                                                    if (fieldTSV != null)
                                                                    {
                                                                        System.Collections.IList lv = (System.Collections.IList)fieldTSV.GetValue(elem);
                                                                        if (lv.Count > 0)
                                                                        {
                                                                            System.Reflection.FieldInfo fn = lv[0].GetType().GetField("Value");
                                                                            if (fn != null)
                                                                            {
                                                                                string vstr = fn.GetValue(lv[0]).ToString();
                                                                                value = "Time Series[" + list.Count + "] {" + lv[0].GetType().Name + "(" + vstr + ")}";

                                                                                System.Diagnostics.Debug.WriteLine(valpath.ToString() + " - " + value);
                                                                            }
                                                                        }
                                                                    }                                                                    

                                                                }
                                                            }
                                                        }
                                                        else
                                                        {
                                                            // use name
                                                            System.Reflection.FieldInfo fieldValue = value.GetType().GetField("Name");
                                                            if (fieldValue != null)
                                                            {
                                                                value = fieldValue.GetValue(value);
                                                            }
                                                        }
                                                    }
                                                    else if (value is System.Collections.IList)
                                                    {
                                                        System.Collections.IList list = (System.Collections.IList)value;
                                                        StringBuilder sbList = new StringBuilder();
                                                        foreach (object elem in list)
                                                        {
                                                            System.Reflection.FieldInfo fieldName = elem.GetType().GetField("Name");
                                                            if (fieldName != null)
                                                            {
                                                                object elemname = fieldName.GetValue(elem);
                                                                if (elemname != null)
                                                                {
                                                                    System.Reflection.FieldInfo fieldValue = elemname.GetType().GetField("Value");
                                                                    if (fieldValue != null)
                                                                    {
                                                                        object elemval = fieldValue.GetValue(elemname);
                                                                        sbList.Append(elemval.ToString());
                                                                    }
                                                                }
                                                            }
                                                            sbList.Append("; <br/>");
                                                        }
                                                        value = sbList.ToString();
                                                    }
                                                    else if (value is Type)
                                                    {
                                                        value = ((Type)value).Name;
                                                    }

                                                    if (!String.IsNullOrEmpty(format))
                                                    {
                                                        if (format.Equals("Required") && value == null)
                                                        {
                                                            includerow = false; //  used for requiring classification for spaces
                                                        }
                                                    }

                                                    if (value != null)
                                                    {
                                                        System.Reflection.FieldInfo fieldValue = value.GetType().GetField("Value");
                                                        if (fieldValue != null)
                                                        {
                                                            value = fieldValue.GetValue(value);
                                                        }

                                                        if (format != null && format.Equals("True") && (value == null || !value.ToString().Equals("True")))
                                                        {
                                                            includerow = false; //  used for requiring exterior walls
                                                        }

                                                        if (value is Double)
                                                        {
                                                            sbRow.Append(" align=\"right\">");

                                                            sbRow.Append(((Double)value).ToString("N3"));
                                                        }
                                                        else if (value is List<Int64>)
                                                        {
                                                            sbRow.Append(">");

                                                            // latitude or longitude
                                                            List<Int64> intlist = (List<Int64>)value;
                                                            if (intlist.Count >= 3)
                                                            {
                                                                sbRow.Append(intlist[0] + "° " + intlist[1] + "' " + intlist[2] + "\"");
                                                            }
                                                        }
                                                        else if (value != null)
                                                        {
                                                            sbRow.Append(">");
                                                            sbRow.Append(value.ToString()); // todo: html-encode
                                                        }
                                                    }
                                                    else
                                                    {
                                                        sbRow.Append(">");
                                                        sbRow.Append("&nbsp;");
                                                    }
                                                }
                                                else
                                                {
                                                    sbRow.Append(">");
                                                }

                                                sbRow.Append("</td>");
                                            }
                                            sbRow.AppendLine("</tr>");

                                            if (includerow)
                                            {
                                                sb.Append(sbRow.ToString());
                                            }
                                        }
                                    }
                                }

                                sb.AppendLine("</table>");
                                sb.AppendLine("<br/>");

                                htmExample.Write(sb.ToString());



                                //htmExample.WriteLine(dataconcept);

                                htmExample.WriteFooter(docPublication.Footer);
                            }

                            string linkid = indexpath[0].ToString();//??
                            string htmllink = "<a class=\"listing-link\" id=\"" + linkid + "\" href=\"" + urlExample + "\" target=\"info\">" + docEntity.Name + "</a>";
                            htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">" + indexpathstring + " " + htmllink + "</td></tr>");

                            // also populate contents on left
                            //...

                        }
                    }
                }
            }
#endif

#if false // older

            foreach (DocModelView docView in docPublication.Views)
            {
                if (docExample.Views.Count == 0 || docExample.Views.Contains(docView))
                {
                    foreach (DocConceptRoot docRoot in docView.ConceptRoots)
                    {
                        // look for specific concept root dealing with mappings
                        foreach (DocTemplateUsage docConcept in docRoot.Concepts)
                        {
                            if (docConcept.Definition != null && docConcept.Definition.Uuid.Equals(DocTemplateDefinition.guidTemplateMapping) && docConcept.Items.Count > 0)//...
                            {
                                bool included = true;

                                if (docExchange != null)
                                {
                                    included = false;
                                    // if exhcnage specified, check for inclusion
                                    foreach (DocExchangeItem docExchangeItem in docConcept.Exchanges)
                                    {
                                        if (docExchangeItem.Exchange == docExchange && docExchangeItem.Requirement == DocExchangeRequirementEnum.Mandatory)
                                        {
                                            included = true;
                                            break;
                                        }
                                    }
                                }

                                // check if there are any instances to populate table
                                // new: populate anyways
                                //included = true;
                                /*
                                if (included)
                                {
                                    included = false;
                                    foreach (SEntity e in instances.Values)
                                    {
                                        string eachname = e.GetType().Name;

                                        if (docRoot.ApplicableEntity.IsInstanceOfType(e))
                                        {
                                            included = true;
                                            break;
                                        }
                                    }
                                }*/

                                if (included)
                                {
                                    string pathExample = path + @"\annex\annex-e\" + MakeLinkName(docExample) + @"\" + MakeLinkName(docRoot.ApplicableEntity) + ".html";
                                    string urlExample = "annex-e/" + MakeLinkName(docExample) + "/" + MakeLinkName(docRoot.ApplicableEntity) + ".html";

                                    indexpath[indexpath.Count - 1]++;

                                    StringBuilder indexpathname = new StringBuilder();
                                    indexpathname.Append("E");
                                    foreach (int x in indexpath)
                                    {
                                        indexpathname.Append(".");
                                        indexpathname.Append(x);
                                    }
                                    string indexpathstring = indexpathname.ToString();


                                    using (FormatHTM htmExample = new FormatHTM(pathExample, mapEntity, mapSchema, mapIncluded))
                                    {
                                        htmExample.WriteHeader(docExample.Name, 3, docPublication.Header);
                                        htmExample.WriteScript(-5, indexpath[0], indexpath[1], 0);
                                        htmExample.WriteLine("<h3 class=\"std\">" + indexpathstring + " " + docRoot.ApplicableEntity.Name + "</h3>");

                                        FormatSQL fmt = new FormatSQL();
                                        string dataconcept = fmt.FormatDataConcept(docProject, docPublication, docExchange, mapEntity, typemap, instances, root, true, docView, docRoot, docConcept);
                                        htmExample.WriteLine(dataconcept);

                                        htmExample.WriteFooter(docPublication.Footer);
                                    }

                                    string linkid = indexpath[0].ToString();//??
                                    string htmllink = "<a class=\"listing-link\" id=\"" + linkid + "\" href=\"" + urlExample + "\" target=\"info\">" + docRoot.ApplicableEntity.Name + "</a>";
                                    htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">" + indexpathstring + " " + htmllink + "</td></tr>");

                                    // also populate contents on left
                                    //...
                                }
                            }
                        }
                    }
                }
            }
#endif

			indexpath.RemoveAt(indexpath.Count - 1);
		}

		/// <summary>
		/// Generates example concept page -- table based on mappings
		/// </summary>
		private static void GenerateExampleConcept()
		{
			//...
		}

		/// <summary>
		/// Generates documentation for template and all sub-templates recursively.
		/// </summary>
		/// <param name="docTemplate"></param>
		/// <param name="indexpath"></param>
		/// <param name="listFigures"></param>
		/// <param name="listTables"></param>
		private static void GenerateTemplate(
			DocProject docProject,
			DocTemplateDefinition docTemplate,
			Dictionary<string, DocObject> mapEntity,
			Dictionary<string, string> mapSchema,
			Dictionary<DocObject, bool> included,
			int[] indexpath,
			List<ContentRef> listFigures,
			List<ContentRef> listTables,
			DocPublication docPublication,
			string path)
		{
			string pathTemplate = path + @"\schema\templates\" + MakeLinkName(docTemplate) + ".html";
			using (FormatHTM htmTemplate = new FormatHTM(pathTemplate, mapEntity, mapSchema, included))
			{
				htmTemplate.WriteHeader(docTemplate.Name, 2, docPublication.Header);

				string indexer = "";
				foreach (int part in indexpath)
				{
					if (indexer.Length != 0)
					{
						indexer += ".";
					}
					indexer += part.ToString();
				}

				htmTemplate.WriteLine(
					 "\r\n" +
					 "<script type=\"text/javascript\">\r\n" +
					 "<!--\r\n" +
					 "    parent.index.location.replace(\"../toc-4.html#" + indexer + "\");\r\n" +
					 "//-->\r\n" +
					 "</script>\r\n");

				string tag = "h" + indexpath.Length.ToString(); // e.g. <h3>
				string id = MakeLinkName(docTemplate);
				htmTemplate.WriteLine("<" + tag + " class=\"std\">" + indexer + " " + docTemplate.Name + "</" + tag + ">");

				string doc = FormatTemplate(docProject, docPublication, docTemplate, listFigures, listTables, mapEntity, mapSchema, included, path);
				htmTemplate.WriteDocumentationMarkup(doc, docTemplate, docPublication, path);

				// write formatted mvdXML
				//htmTemplate.WriteLine("<details open=\"open\">");
				//htmTemplate.WriteLine("<summary>mvdXML</summary>");

				ConceptTemplate mvdTemplate = new ConceptTemplate();
				Program.ExportMvdTemplate(mvdTemplate, docTemplate, included, false);
				System.Xml.Serialization.XmlSerializer ser = new System.Xml.Serialization.XmlSerializer(typeof(ConceptTemplate));
				StringBuilder mvdOutput = new StringBuilder();
				using (System.IO.Stream streamMVD = new System.IO.MemoryStream())
				{
					ser.Serialize(streamMVD, mvdTemplate, null);
					streamMVD.Position = 0;
					using (System.IO.StreamReader reader = new System.IO.StreamReader(streamMVD))
					{
						while (!reader.EndOfStream)
						{
							string mvdLine = reader.ReadLine();

							int pos = 0;
							while (pos < mvdLine.Length && mvdLine[pos] == ' ')
							{
								mvdOutput.Append("\t");
								pos++;
							}

							// replace any leading spaces with tabs for proper formatting
							string mvdMark = mvdLine.Substring(pos, mvdLine.Length - pos);
							mvdOutput.AppendLine(mvdMark);
						}
					}
				}

				if (!docPublication.ISO)
				{
					htmTemplate.WriteSummaryHeader("mvdXML Specification", false, docPublication);
					htmTemplate.WriteLine("<div class=\"xsd\"><code class=\"xsd\">");
					htmTemplate.WriteExpression(mvdOutput.ToString(), "../../"); //... need to use tabs...
					htmTemplate.WriteLine("</code></div>");
					htmTemplate.WriteSummaryFooter(docPublication);
				}

				if (docProject.Examples != null)
				{
					List<DocExample> listExample = new List<DocExample>();
					foreach (DocExample docExample in docProject.Examples)
					{
						BuildExampleList(listExample, docExample, docTemplate, included);
					}
					if (listExample.Count > 0)
					{
						htmTemplate.WriteLine("<p class=\"spec-head\">Examples:</p>");
						htmTemplate.WriteLine("<ul>");
						foreach (DocExample docExample in listExample)
						{
							if (docExample.Name != null)
							{
								htmTemplate.Write("<li><a href=\"../../annex/annex-e/");
								htmTemplate.Write(MakeLinkName(docExample));
								htmTemplate.Write(".html\">");
								htmTemplate.Write(docExample.Name);
								htmTemplate.Write("</a></li>");
								htmTemplate.WriteLine("");
							}
						}
						htmTemplate.WriteLine("</ul>");
					}
				}

				// write url for incoming page link                
				htmTemplate.WriteLinkTo(docProject, docPublication, docTemplate);

				htmTemplate.WriteFooter(docPublication.Footer);
			}

			// recurse
			int iTemplate = 0;
			foreach (DocTemplateDefinition docSubTemplate in docTemplate.Templates)
			{
				if (included == null || included.ContainsKey(docSubTemplate))
				{
					iTemplate++;
					int[] subindexpath = new int[indexpath.Length + 1];
					indexpath.CopyTo(subindexpath, 0);
					subindexpath[subindexpath.Length - 1] = iTemplate;
					GenerateTemplate(docProject, docSubTemplate, mapEntity, mapSchema, included, subindexpath, listFigures, listTables, docPublication, path);
				}
			}
		}

		private static string FormatEntityDescription(
			DocProject docProject,
			DocEntity entity,
			List<ContentRef> listFigures,
			List<ContentRef> listTables)
		{
			StringBuilder sb = new StringBuilder();
			string documentation = UpdateNumbering(entity.DocumentationHtml(), listFigures, listTables, entity);
			sb.Append(documentation);
			return sb.ToString();
		}

		private static string FormatEntityConcepts(
			DocProject docProject,
			DocEntity entity,
			Dictionary<string, DocObject> mapEntity,
			Dictionary<string, string> mapSchema,
			Dictionary<DocObject, bool> included,
			List<ContentRef> listFigures,
			List<ContentRef> listTables,
			string path,
			DocPublication docPublication)
		{
			// no longer show for requirement-driven MVDs such as for GSA where requirements are shown in first section -- just adds cruft
			if (docPublication.Exchanges)
				return String.Empty;

			StringBuilder sb = new StringBuilder();

			// build list of views
			List<DocModelView> listView = new List<DocModelView>();
			foreach (DocModelView docView in docPublication.Views)
			{
				BuildViewList(docProject, listView, docView);
			}

			// find concepts for entity
			foreach (DocModelView docView in listView)
			{
				//if (included == null || included.ContainsKey(docView))
				if (docView.ConceptRoots.Count > 0 && docView.Status != "Sample")
				{
					// check if there are any applicable concepts
					bool hasConceptsAtEntity = false;
					foreach (DocConceptRoot docRoot in docView.ConceptRoots)
					{
						if (docRoot.ApplicableEntity == entity)
						{
							hasConceptsAtEntity = true;
						}
					}

					// inherited use definitions

					// build list of inherited views
					DocModelView[] listViews = docProject.GetViewInheritance(docView);

					List<string> listLines = new List<string>();
					Dictionary<DocTemplateDefinition, DocTemplateUsage> mapSuper = new Dictionary<DocTemplateDefinition, DocTemplateUsage>();
					List<DocTemplateDefinition> listSuppress = new List<DocTemplateDefinition>();
					List<DocTemplateDefinition> listOverride = new List<DocTemplateDefinition>();
					DocEntity docSuper = entity;
					while (docSuper != null)
					{
						StringBuilder sbSuper = new StringBuilder();

						// find parent concept roots
						bool renderclass = false;
						foreach (DocModelView docViewBase in listViews)
						{
							foreach (DocConceptRoot docSuperRoot in docViewBase.ConceptRoots)
							{
								if (docSuperRoot.ApplicableEntity == docSuper)
								{
									string schema = mapSchema[docSuper.Name].ToLower();

									foreach (DocTemplateUsage docSuperUsage in docSuperRoot.Concepts)
									{
										bool flag = false;
										if (docSuperUsage.Suppress)
										{
											if (!listSuppress.Contains(docSuperUsage.Definition))
											{
												listSuppress.Add(docSuperUsage.Definition);
												flag = true;
											}
										}
										else if (docSuperUsage.Override)
										{
											if (!listOverride.Contains(docSuperUsage.Definition))
											{
												listOverride.Add(docSuperUsage.Definition);
												flag = true;
											}
										}

										if (docSuperUsage.Definition != null && !mapSuper.ContainsKey(docSuperUsage.Definition) && !docSuperUsage.Suppress)
										{
											if (!renderclass)
											{
												renderclass = true;

												sbSuper.Append("<tr><td colspan=\"3\">");
												sbSuper.Append("<a href=\"../../" + schema + "/lexical/" + MakeLinkName(docSuper) + ".html\">");
												if (docSuper.IsAbstract)
												{
													sbSuper.Append("<i>");
													sbSuper.Append(docSuper.Name);
													sbSuper.Append("</i>");
												}
												else
												{
													sbSuper.Append(docSuper.Name);
												}
												sbSuper.Append("</a></td></tr>");
											}

											bool suppress = listSuppress.Contains(docSuperUsage.Definition);
											bool overiden = listOverride.Contains(docSuperUsage.Definition);

											foreach (DocTemplateDefinition dtd in listSuppress)
											{
												if (docSuperUsage.Definition == dtd || docSuperUsage.Definition.Templates.Contains(dtd))
												{
													suppress = true;
													break;
												}
											}

											foreach (DocTemplateDefinition dtd in listOverride)
											{
												if (docSuperUsage.Definition == dtd || docSuperUsage.Definition.Templates.Contains(dtd))
												{
													overiden = true;
													break;
												}
											}

											if (flag)
											{
												suppress = false;
												overiden = false;
											}

											sbSuper.Append("<tr><td> </td><td>");

											mapSuper.Add(docSuperUsage.Definition, docSuperUsage);

											string templateid = MakeLinkName(docSuperUsage.Definition);

											sbSuper.Append("<a href=\"../../");
											sbSuper.Append(schema);
											sbSuper.Append("/lexical/" + MakeLinkName(docSuper) + ".html#" + templateid + "\">");
											if (suppress || overiden)
											{
												sbSuper.Append("<del>");
											}
											if (!String.IsNullOrEmpty(docSuperUsage.Name))
											{
												sbSuper.Append(docSuperUsage.Name);
											}
											else
											{
												sbSuper.Append(docSuperUsage.Definition.Name);
											}
											if (suppress || overiden)
											{
												sbSuper.Append("</del>");
											}
											sbSuper.Append("</a>");
											if (overiden)
											{
												sbSuper.Append(" (overridden)");
											}
											else if (suppress)
											{
												sbSuper.Append(" (suppressed)");
											}

											sbSuper.Append("</td><td>");
											sbSuper.Append("<a href=\"../../templates/" + MakeLinkName(docSuperUsage.Definition) + ".html\">" + docSuperUsage.Definition + "</a>");
											sbSuper.Append("</td><td>");
											sbSuper.Append(docViewBase.Name);
											sbSuper.Append("</td></tr>");
											sbSuper.AppendLine();
										}
									}

								}
							}
						}

						if (sbSuper.Length > 0)
						{
							listLines.Add(sbSuper.ToString());
						}

						// go to base type
						docSuper = docProject.GetDefinition(docSuper.BaseDefinition) as DocEntity;
					}

					if (hasConceptsAtEntity || listLines.Count > 0)
					{
						sb.AppendLine("<section>");
						sb.AppendLine("<h5 class=\"num\">Definitions applying to " + docView.Name + "</h5>");

						// link to instance diagram
						if (hasConceptsAtEntity)
						{
							string linkdiagram = MakeLinkName(docView) + "/" + MakeLinkName(entity) + ".html";
							sb.Append("<p><a href=\"../../../annex/annex-d/" + linkdiagram + "\"><img style=\"border: 0px\" src=\"../../../img/diagram.png\" />&nbsp;Instance diagram</a></p>");
						}

						sb.AppendLine("<hr />");

						foreach (DocConceptRoot docRoot in docView.ConceptRoots)
						{
							if (docRoot.ApplicableEntity == entity)
							{
								sb.Append("<h5>" + docRoot.Name + "</h5>");

								if (docRoot.ApplicableTemplate != null)
								{
									string applicabletemplatetable = FormatConceptTable(docProject, docView, entity, docRoot, null, mapEntity, mapSchema);
									sb.Append(applicabletemplatetable);
								}

								sb.Append(docRoot.DocumentationHtml());

								if (docRoot.Concepts.Count > 0)
								{
									if (!docPublication.ISO)
									{
										sb.AppendLine("<details open=\"open\">");
										sb.AppendLine("<summary>Concept usage</summary>");
									}

									foreach (DocTemplateUsage eachusage in docRoot.Concepts)
									{
										FormatEntityUsage(docProject, entity, docView, docRoot, eachusage, mapEntity, mapSchema, listFigures, listTables, included, sb, path, docPublication);
									}

									if (!docPublication.ISO)
									{
										sb.AppendLine("</details>");

										//... mvdXML for entire root
										ConceptRoot mvdConceptRoot = new ConceptRoot();
										List<DocTemplateDefinition> listPrivateTemplates = new List<DocTemplateDefinition>();
										Program.ExportMvdConceptRoot(mvdConceptRoot, docRoot, docProject, null, mapEntity, false, listPrivateTemplates);
										System.Xml.Serialization.XmlSerializer ser = new System.Xml.Serialization.XmlSerializer(typeof(ConceptRoot));
										StringBuilder mvdOutput = new StringBuilder();
										using (System.IO.Stream streamMVD = new System.IO.MemoryStream())
										{
											ser.Serialize(streamMVD, mvdConceptRoot, null);
											streamMVD.Position = 0;
											using (System.IO.StreamReader reader = new System.IO.StreamReader(streamMVD))
											{
												while (!reader.EndOfStream)
												{
													string mvdLine = reader.ReadLine();

													int pos = 0;
													while (pos < mvdLine.Length && mvdLine[pos] == ' ')
													{
														mvdOutput.Append("\t");
														pos++;
													}

													// replace any leading spaces with tabs for proper formatting
													string mvdMark = mvdLine.Substring(pos, mvdLine.Length - pos);
													mvdOutput.AppendLine(mvdMark);
												}
											}
										}

										string html = System.Web.HttpUtility.HtmlEncode(mvdOutput.ToString());
										html = html.Replace("\r\n", "<br/>\r\n");
										html = html.Replace("\t", "&nbsp;");

										//sb.AppendLine("<section>");
										sb.AppendLine("<details><summary>mvdXML Specification</summary>");
										sb.AppendLine("<div class=\"xsd\"><code class=\"xsd\">");
										sb.AppendLine(html); //... need to use tabs...
															 //sb.AppendLine(mvdOutput.ToString());
										sb.AppendLine("</code></div></details>");
										//sb.AppendLine("</section>");
									}
								}

							}
						}
					}


					// now format inherited use definitions
					if (listLines.Count > 0 && !docPublication.ISO)
					{
						sb.AppendLine("<section>");

						sb.AppendLine("<details>");
						sb.AppendLine("<summary>Concept inheritance</summary>");
						sb.AppendLine("<p><table class=\"attributes\">");
						sb.AppendLine("<tr><th><b>#</b></th><th><b>Concept</b></th><th><b>Template</b></th><th><b>Model View</b></th></tr>");
						for (int iLine = listLines.Count - 1; iLine >= 0; iLine--)
						{
							// reverse order
							sb.AppendLine(listLines[iLine]);
						}
						sb.AppendLine("</table>");
						sb.AppendLine("</details>");
						sb.AppendLine("</section>");

					}


					sb.AppendLine("</section>");
				}
			}

			return sb.ToString();
		}

		private static void FormatEntityUsage(DocProject docProject, DocEntity entity, DocModelView docView, DocConceptRoot docRoot, DocTemplateUsage eachusage, Dictionary<string, DocObject> mapEntity, Dictionary<string, string> mapSchema, List<ContentRef> listFigures, List<ContentRef> listTables, Dictionary<DocObject, bool> included, StringBuilder sb, string path, DocPublication docPublication)
		{
			if (eachusage.Definition != null)
			{
				if (included == null || included.ContainsKey(eachusage.Definition))
				{
					string documentation = UpdateNumbering(eachusage.DocumentationHtml(), listFigures, listTables, entity);

					string eachtext = FormatConcept(docProject, entity, docView, docRoot, eachusage, documentation, mapEntity, mapSchema, listFigures, listTables, path, docPublication);
					sb.Append(eachtext);
					sb.AppendLine();

					if (eachusage.Concepts.Count > 0 && !docPublication.ISO)
					{
						sb.AppendLine("<details>");
						sb.AppendLine("<summary>Concept alternates</summary>");

						foreach (DocTemplateUsage innerusage in eachusage.Concepts)
						{
							FormatEntityUsage(docProject, entity, docView, docRoot, innerusage, mapEntity, mapSchema, listFigures, listTables, included, sb, path, docPublication);
						}
						sb.AppendLine("</details>");
					}
				}
			}
		}


		/// <summary>
		/// Updates content containing figure references
		/// </summary>
		/// <param name="html">Content to parse</param>
		/// <param name="figurenumber">Last figure number; returns updated last figure number</param>
		/// <param name="tablenumber">Last table number; returns updated last table number</param>
		/// <returns>Updated content</returns>
		internal static string UpdateNumbering(string html, List<ContentRef> listFigures, List<ContentRef> listTables, DocObject target)
		{
			if (string.IsNullOrEmpty(html))
				return null;

			html = UpdateNumbering(html, "Figure", "figure", listFigures, target);
			html = UpdateNumbering(html, "Table", "table", listTables, target);
			return html;
		}

		/// <summary>
		/// Updates numbering of figures or tables within HTML text
		/// </summary>
		/// <param name="html">The existing HTML</param>
		/// <param name="tag">The caption to find -- either 'Figure' or 'Table'</param>
		/// <param name="style">The style to find -- either 'figure' or 'table'</param>
		/// <param name="listRef">List of items where numbering begins and items are added.</param>
		/// <returns>The new HTML with figures or numbers updated</returns>
		private static string UpdateNumbering(string html, string tag, string style, List<ContentRef> listRef, DocObject target)
		{
			Dictionary<int, int> list = new Dictionary<int, int>();

			html = html.Replace("—", "&mdash;");
			// first get numbers of existing figures (must be unique within page)
			int index = 0;
			for (int count = 0; ; count++)
			{
				index = html.IndexOf("<p class=\"" + style + "\">", index);
				if (index == -1)
					break;

				// <p class="figure">Figure 278 &mdash; Circle geometry</p>
				// <p class="table">Table 278 &mdash; Circle geometry</p>

				// get the existing figure number, add it to list
				int head = index + 13 + tag.Length * 2; // was 25
				int tail = html.IndexOf(" &mdash;", index);
				if (tail > head)
				{
					string exist = html.Substring(head, tail - head);
					int result = 0;
					if (Int32.TryParse(exist, out result))
					{
						list[result] = listRef.Count + 1;


						int endcaption = html.IndexOf("<", tail);
						string figuretext = html.Substring(tail + 9, endcaption - tail - 9);

						listRef.Add(new ContentRef(figuretext, target));
					}
					else
						System.Diagnostics.Debug.WriteLine(target == null ? "" : target.Name + "invalid " + tag + " numbering :" + exist);
				}

				index++;
			}

			if (list.Count > 0)
			{
				// renumber in two phases (to avoid renumbering same)

				// now renumber
				foreach(KeyValuePair<int,int> pair in list)
				{
					string captionold = tag + " " + pair.Key;// +" ";
					string captionnew = tag + "#" + pair.Value;// +" ";

					// handle cases of space, comma, and period following figure reference
					html = html.Replace(captionold + " ", captionnew + " ");
					html = html.Replace(captionold + ",", captionnew + ",");
					html = html.Replace(captionold + ".", captionnew + ".");
				}

				// then replace all
				html = html.Replace(tag + "#", tag + " ");
			}

			//itemnumber += list.Count;

			return html;
		}

		public static void GenerateListings(
			DocProject docProject, DocPublication docPublication, DocModelView docModelView,
			Dictionary<string, DocObject> mapEntity, Dictionary<string, string> mapSchema, Dictionary<DocObject, bool> included,
			string[] locales, Dictionary<DocFormatSchemaEnum, IFormatExtension> mapFormatSchema,
			int[] indexpath, string pathPublication,
			FormatHTM htmTOC, FormatHTM htmSectionTOC)
		{
			string path = pathPublication + @"\html";

			string code = docModelView.Code;
			if (String.IsNullOrEmpty(code))
			{
				// fallback on name
				code = MakeLinkName(docModelView);
			}

			string indexer = "";
			foreach (int part in indexpath)
			{
				if (indexer.Length != 0)
				{
					indexer += ".";
				}
				indexer += part.ToString();
			}

			htmTOC.WriteTOC(1, "<a class=\"listing-link\" href=\"annex/annex-a/" + MakeLinkName(docModelView) + "/index.html\" >A." + indexer + " " + docModelView.Name + "</a>");

			htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">A." + indexer + " <a href=\"annex-a/" + MakeLinkName(docModelView) + "/index.html\" target=\"info\" >" + docModelView.Name + "</a></td></tr>");

			// create page for model view
			string pathRoot = path + @"\annex\annex-a\" + MakeLinkName(docModelView) + @"\index.html";
			using (FormatHTM htmRoot = new FormatHTM(pathRoot, mapEntity, mapSchema, included))
			{
				htmRoot.WriteComputerListing(docModelView.Name, docModelView.Code, indexpath, docPublication);
			}

			if (!String.IsNullOrEmpty(docModelView.Code))
			{
				// show filtered schemas for model views only if exchanges defined
				DocModelView[] modelviews = docProject.GetViewInheritance(docModelView);

				DoExport(docProject, docPublication, path + @"\annex\annex-a\" + MakeLinkName(docModelView) + @"\" + code + ".exp", modelviews, locales, DocDefinitionScopeEnum.Default, null, mapEntity);
				//DoExport(docProject, path + @"\annex\annex-a\" + MakeLinkName(docModelView) + @"\" + code + ".xsd", modelviews, locales, DocDefinitionScopeEnum.Default, instances, mapEntity);
				DoExport(docProject, docPublication, path + @"\annex\annex-a\" + MakeLinkName(docModelView) + @"\" + code + ".ifc", modelviews, locales, DocDefinitionScopeEnum.Default, null, mapEntity);
				DoExport(docProject, docPublication, path + @"\annex\annex-a\" + MakeLinkName(docModelView) + @"\" + code + ".ifcxml", modelviews, locales, DocDefinitionScopeEnum.Default, null, mapEntity);
				DoExport(docProject, docPublication, path + @"\annex\annex-a\" + MakeLinkName(docModelView) + @"\" + code + ".xml", modelviews, locales, DocDefinitionScopeEnum.Default, null, mapEntity);
				DoExport(docProject, docPublication, path + @"\annex\annex-a\" + MakeLinkName(docModelView) + @"\" + code + "-psd.zip_", modelviews, locales, DocDefinitionScopeEnum.Default, null, mapEntity);
				DoExport(docProject, docPublication, path + @"\annex\annex-a\" + MakeLinkName(docModelView) + @"\" + code + "-qto.zip_", modelviews, locales, DocDefinitionScopeEnum.Default, null, mapEntity);

				if (docPublication.GetFormatOption(DocFormatSchemaEnum.STEP) != DocFormatOptionEnum.None)
				{
					using (FormatHTM htmExpress = new FormatHTM(path + @"\annex\annex-a\" + MakeLinkName(docModelView) + @"\" + code + ".exp.html", mapEntity, mapSchema, included))
					{
						htmExpress.UseAnchors = true;
						htmExpress.WriteHeader("EXPRESS", 3, docPublication.Header);
						htmExpress.WriteExpressSchema(docProject);
						htmExpress.WriteFooter("");
					}

					// copy over to main directory
					//string pathSource = path + @"\annex\annex-a\" + MakeLinkName(docModelView) + @"\" + code + ".exp";
					//string pathTarget = pathPublication + @"\" + docProject.GetSchemaIdentifier() + "_" + docPublication.GetReleaseIdentifier() + ".exp";
					//System.IO.File.Copy(pathSource, pathTarget, true);

					// change: root always has full schema
					// long-form
					string pathTarget = pathPublication + @"\" + docProject.GetSchemaIdentifier() + ".exp";
					DoExport(docProject, docPublication, pathTarget, null, null, DocDefinitionScopeEnum.Default, null, mapEntity);

					// short-form
					foreach (DocSection docSection in docProject.Sections)
					{
						foreach (DocSchema docSchema in docSection.Schemas)
						{
							string pathSchema = pathPublication + @"\" + docSchema.Name + ".exp";
							using (FormatEXP format = new FormatEXP(docProject, docSchema, null, pathSchema))
							{
								format.Save();
							}
						}
					}
				}

				DoExport(docProject, docPublication, path + @"\annex\annex-a\" + MakeLinkName(docModelView) + @"\" + code + ".mvdxml", new DocModelView[] { docModelView }, locales, DocDefinitionScopeEnum.Default, null, mapEntity);

				foreach (DocFormat docFormat in docPublication.Formats)
				{
					IFormatExtension formatextension = null;
					if (docFormat.FormatOptions != DocFormatOptionEnum.None && mapFormatSchema.TryGetValue(docFormat.FormatType, out formatextension))
					{
						string content = formatextension.FormatDefinitions(docProject, docPublication, mapEntity, included);
						using (System.IO.StreamWriter writer = new System.IO.StreamWriter(path + @"\annex\annex-a\" + MakeLinkName(docModelView) + @"\" + code + "." + docFormat.ExtensionSchema, false))
						{
							writer.Write(content);
						}

						// write formatted
						using (FormatHTM htmFormat = new FormatHTM(path + @"\annex\annex-a\" + MakeLinkName(docModelView) + @"\" + code + "." + docFormat.ExtensionSchema + ".html", mapEntity, mapSchema, included))
						{
							htmFormat.UseAnchors = false;
							htmFormat.WriteHeader(docFormat.ExtensionSchema, 3, docPublication.Header);
							htmFormat.WriteExpression(content, "../../schema/");
							htmFormat.WriteFooter("");
						}

						// copy to main directory
						//System.IO.File.Copy(
						//    path + @"\annex\annex-a\" + MakeLinkName(docModelView) + @"\" + code + "." + docFormat.ExtensionSchema,
						//    pathPublication + @"\" + docProject.GetSchemaIdentifier() + "_" + docPublication.GetReleaseIdentifier() + "." + docFormat.ExtensionSchema, true);

						// change: root always has full schema
						string pathTarget = pathPublication + @"\" + docProject.GetSchemaIdentifier() + "." + docFormat.ExtensionSchema;
						//DoExport(docProject, docPublication, pathTarget, null, null, DocDefinitionScopeEnum.Default, instances, mapEntity);
						string fullcontent = formatextension.FormatDefinitions(docProject, docPublication, mapEntity, null);
						using (System.IO.StreamWriter writer = new System.IO.StreamWriter(pathTarget, false))
						{
							writer.Write(fullcontent);
						}
					}
				}
			}

			// recurse through sub-views
			int iTemplate = 0;
			foreach (DocModelView docSub in docModelView.ModelViews)
			{
				iTemplate++;
				int[] subindexpath = new int[indexpath.Length + 1];
				indexpath.CopyTo(subindexpath, 0);
				subindexpath[subindexpath.Length - 1] = iTemplate;

				GenerateListings(docProject, docPublication, docSub, mapEntity, mapSchema, included,
					locales, mapFormatSchema, subindexpath, pathPublication, htmTOC, htmSectionTOC);
			}
		}

		/// <summary>
		/// 
		/// </summary>
		/// <param name="docProject"></param>
		/// <param name="docPublication"></param>
		/// <param name="docProjectModelView">The view to generate, along with any sub-views within</param>
		/// <param name="mapEntity"></param>
		/// <param name="mapSchema"></param>
		/// <param name="included"></param>
		/// <param name="indexpath"></param>
		/// <param name="path"></param>
		public static void GenerateView(
			DocProject docProject, DocPublication docPublication, DocModelView docProjectModelView,
			Dictionary<string, DocObject> mapEntity, Dictionary<string, string> mapSchema, Dictionary<DocObject, bool> included, int[] indexpath, string path,
			FormatHTM htmTOC, FormatHTM htmSectionTOC)
		{
			string indexer = "";
			foreach (int part in indexpath)
			{
				if (indexer.Length != 0)
				{
					indexer += ".";
				}
				indexer += part.ToString();
			}

			string pathSchema = path + @"\schema";


			string htmllink = "<a class=\"listing-link\" href=\"views/" + MakeLinkName(docProjectModelView) + "/index.html\" target=\"info\">" +
				indexer + " " + docProjectModelView.Name + "</a>";
			htmTOC.WriteTOC(1, "<a class=\"listing-link\" href=\"schema/views/" + MakeLinkName(docProjectModelView) + "/index.html\" >" +
				indexer + " " + docProjectModelView.Name + "</a>");
			htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">" + htmllink + "</td></tr>");

			if (docPublication.Exchanges)
			{
				int iExchange = 0;
				foreach (DocExchangeDefinition docExchange in docProjectModelView.Exchanges)
				{
					iExchange++;

					htmllink = "<a class=\"listing-link\" href=\"views/" + MakeLinkName(docProjectModelView) + "/" + MakeLinkName(docExchange) + ".html\" target=\"info\">" +
						indexer + "." + iExchange.ToString() + " " + docExchange.Name + "</a>";

					htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"schema/views/" + MakeLinkName(docProjectModelView) + "/" + MakeLinkName(docExchange) + ".html\" >" +
						indexer + "." + iExchange.ToString() + " " + docExchange.Name + "</a>");
					htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">" + htmllink + "</td></tr>");
				}
			}


			//iView++;
			int iView = indexpath[1]; // top-level view

			string pathTemplate = pathSchema + @"\views\" + MakeLinkName(docProjectModelView) + "\\index.html";
			using (FormatHTM htmTemplate = new FormatHTM(pathTemplate, mapEntity, mapSchema, included))
			{
				htmTemplate.WriteHeader(docProjectModelView.Name, 1, iView, 0, 0, docPublication.Header);
				htmTemplate.WriteScript(1, iView, 0, 0);
				{
					string tag = "h3";
					string id = docProjectModelView.Name.ToLower();
					htmTemplate.WriteLine("<" + tag + "><a id=\"" + id + "\" name=\"" + id + "\">" + indexer + " " + docProjectModelView.Name + "</a></" + tag + ">");

					// write table of status for MVD
					if (!docPublication.ISO && !String.IsNullOrEmpty(docProjectModelView.Code))
					{
						htmTemplate.WriteLine("<table class=\"gridtable\">");
						htmTemplate.WriteLine("<tr><th>Code</th><th>Version</th><th>Status</th><th>Author</th><th>Copyright</th></tr>");
						htmTemplate.WriteLine("<tr><td>" + docProjectModelView.Code + "</td><td>" + docProjectModelView.Version + "</td><td>" + docProjectModelView.Status + "</td><td>" + docProjectModelView.Author + "</td><td>" + docProjectModelView.Copyright + "</td></tr>");
						htmTemplate.WriteLine("</table>");
					}

					string viewtable = FormatView(docProject, docPublication, docProjectModelView, mapEntity, mapSchema, new StringBuilder());
					htmTemplate.WriteDocumentationMarkup(viewtable, docProjectModelView, docPublication, path);

					// write tables within MVD

				}

				htmTemplate.WriteFooter(docPublication.Footer);
			}

			// icon for view
			if (docProjectModelView.Icon != null)
			{
				string pathIcon = path + @"\img\view-" + MakeLinkName(docProjectModelView) + ".png";

				try
				{
					string pathIconDir = System.IO.Path.GetDirectoryName(pathIcon);
					if (!System.IO.Directory.Exists(pathIconDir))
					{
						System.IO.Directory.CreateDirectory(pathIconDir);
					}

					using (System.IO.FileStream fs = new System.IO.FileStream(pathIcon, System.IO.FileMode.Create))
					{
						fs.Write(docProjectModelView.Icon, 0, docProjectModelView.Icon.Length);
						fs.Close();
					}
				}
				catch
				{
				}
			}

			// each exchange... (or sub-page?)

			if (docPublication.Exchanges)//Properties.Settings.Default.Requirement)
			{
				for (int iExchange = 0; iExchange < docProjectModelView.Exchanges.Count; iExchange++)
				{
					DocExchangeDefinition docExchange = docProjectModelView.Exchanges[iExchange];

					string pathExchange = pathSchema + @"\views\" + MakeLinkName(docProjectModelView) + "\\" + MakeLinkName(docExchange) + ".html";
					using (FormatHTM htmExchange = new FormatHTM(pathExchange, mapEntity, mapSchema, included))
					{
						htmExchange.WriteHeader(docExchange.Name, 1, iView, 0, 0, docPublication.Header);
						htmExchange.WriteScript(1, iView, iExchange + 1, 0);

						string exchangeindexer = indexer + "." + (iExchange + 1).ToString();
						string tag = "h4";
						string id = docExchange.Name.ToLower();

						htmExchange.WriteLine("<" + tag + "><a id=\"" + id + "\" name=\"" + id + "\">" + exchangeindexer + " " + docExchange.Name + "</a></" + tag + ">");
						htmExchange.WriteLine("<p class=\"std\">");

						string exchangedoc = FormatExchange(docProject, docProjectModelView, docExchange, mapEntity, mapSchema, docPublication);
						htmExchange.WriteDocumentationMarkup(exchangedoc, docExchange, docPublication, path);
						htmExchange.WriteLine("</p>");
					}

					// icons for each exchange
					if (docExchange.Icon != null)
					{
						string pathIcon = path + @"\img\mvd-" + MakeLinkName(docExchange) + ".png";

						try
						{
							using (System.IO.FileStream fs = new System.IO.FileStream(pathIcon, System.IO.FileMode.Create))
							{
								fs.Write(docExchange.Icon, 0, docExchange.Icon.Length);
								fs.Close();
							}
						}
						catch
						{
						}
					}
				}
			}

			// recurse to sub-views
			int iTemplate = 0;
			foreach (DocModelView docSubView in docProjectModelView.ModelViews)
			{
				//if (included == null || included.ContainsKey(docSubTemplate))
				if (!docSubView.IsDeprecated())
				{
					iTemplate++;
					int[] subindexpath = new int[indexpath.Length + 1];
					indexpath.CopyTo(subindexpath, 0);
					subindexpath[subindexpath.Length - 1] = iTemplate;
					GenerateView(docProject, docPublication, docSubView, mapEntity, mapSchema, included, subindexpath, path, htmTOC, htmSectionTOC);
				}
			}

		}

		public static List<string> Generate(
			DocProject docProject,
			string path,
			Dictionary<string, DocObject> mapEntity,
			Dictionary<string, string> mapSchema,
			DocPublication[] publications,
			BackgroundWorker worker,
			FormProgress formProgress)
		{
			string releasepath = path + @"\" + MakeLinkName(docProject.GetSchemaVersion());
			List<string> indexPaths = new List<string>();
			foreach (DocPublication docPub in publications)
			{
				string relpath = releasepath + @"\" + MakeLinkName(string.IsNullOrEmpty(docPub.Code) ? docPub.Name : docPub.Code);
				indexPaths.Add(GeneratePublication(docProject, relpath, mapEntity, mapSchema, docPub, worker, formProgress));
			}
			return indexPaths;
		}

		public static string GeneratePublication(
			DocProject docProject,
			string pathPublication,
			Dictionary<string, DocObject> mapEntity,
			Dictionary<string, string> mapSchema,
			DocPublication docPublication,
			BackgroundWorker worker,
			FormProgress formProgress)
		{
			docPublication.ErrorLog.Clear();

			string path = pathPublication + @"\html";
			System.IO.Directory.CreateDirectory(pathPublication); // ensure directory exists
			System.IO.Directory.CreateDirectory(path); // ensure directory exists

			DiagramFormat diagramformat = DiagramFormat.ExpressG;
			if (docPublication.UML)
			{
				diagramformat = DiagramFormat.UML;
			}

			DocModelView[] views = docPublication.Views.ToArray();

			List<DocXsdFormat> xsdFormatBase = docProject.BuildXsdFormatList();
			string xmlns = "https://standards.buildingsmart.org/IFC/RELEASE/IFC4/Add2TC1";

			if (views.Length > 0 && !String.IsNullOrEmpty(views[0].XsdUri))
			{
				xmlns = views[0].XsdUri;
			}

			List<DocChangeSet> listChangeSets = docProject.ChangeSets;
			if (docPublication.ChangeSets.Count > 0)
			{
				// override change sets for publication
				listChangeSets = docPublication.ChangeSets;
			}

			// compile schema and extract the IfcProject type
			Type typeProject = typeof(IfcContext);// Compiler.CompileProject(docProject);

			// for now these are paired; in future they may be split
			Dictionary<DocFormatSchemaEnum, IFormatExtension> mapFormatSchema = new Dictionary<DocFormatSchemaEnum, IFormatExtension>();
			Dictionary<DocFormatSchemaEnum, Serializer> mapFormatData = new Dictionary<DocFormatSchemaEnum, Serializer>();
			foreach (DocFormat docFormat in docPublication.Formats)
			{
				switch (docFormat.FormatType)
				{
					case DocFormatSchemaEnum.STEP:
						mapFormatData.Add(docFormat.FormatType, new StepSerializer(typeProject));
						break;

					case DocFormatSchemaEnum.OWL:
						mapFormatSchema.Add(docFormat.FormatType, new FormatOWL());
						mapFormatData.Add(docFormat.FormatType, new TurtleSerializer(typeProject));
						break;

					case DocFormatSchemaEnum.SQL:
						mapFormatSchema.Add(docFormat.FormatType, new FormatSQL());
						break;

					case DocFormatSchemaEnum.CS:
						mapFormatSchema.Add(docFormat.FormatType, new FormatCSC());
						break;

					case DocFormatSchemaEnum.JSON:
						mapFormatSchema.Add(docFormat.FormatType, new FormatJAV());
						mapFormatData.Add(docFormat.FormatType, new JsonSerializer(typeProject));
						break;

					case DocFormatSchemaEnum.XML:
						mapFormatSchema.Add(docFormat.FormatType, new FormatXSD(null));
						string version = docProject.GetSchemaVersion();
						XmlSerializer serializer = new XmlSerializer(typeProject);
						if(string.IsNullOrEmpty(version))
						{
							

						}
						else if(version.StartsWith("2.3.0"))
						{
							serializer.NameSpace = @"http://www.iai-tech.org/ifcXML/IFC2x3/FINAL";
							serializer.SchemaLocation = @"https://standards.buildingsmart.org/IFC/RELEASE/IFC2x3/TC1/XML/IFC2X3.xsd";
						}
						else if (version.StartsWith("4.0.2.1"))
						{
							serializer.NameSpace = @"https://standards.buildingsmart.org/IFC/RELEASE/IFC4/Add2TC1";
							serializer.SchemaLocation = @"https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/XML/IFC4.xsd";
						}
						else if(version.StartsWith("4.0.2"))
						{
							serializer.NameSpace = @"http://www.buildingsmart-tech.org/ifcXML/IFC4/Add2";
							serializer.SchemaLocation = @"https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2/XML/IFC4_ADD2.xsd";
						}
						else if (version.StartsWith("4.1"))
						{
							serializer.NameSpace = @"http://www.buildingsmart-tech.org/ifc/IFC4x1/final";
							serializer.SchemaLocation = @"https://standards.buildingsmart.org/IFC/RELEASE/IFC4_1/FINAL/XML/IFC4x1.xsd";
						}
						else if (version.StartsWith("4.2"))
						{
							serializer.NameSpace = @"http://www.buildingsmart-tech.org/ifc/review/IFC4x2/unspecifiedrelease";
							serializer.SchemaLocation = @"https://standards.buildingsmart.org/IFC/DEV/IFC4_2/FINAL/XML/IFC4x2.xsd";
						}
						mapFormatData.Add(docFormat.FormatType, serializer);
						break;

				}
			}


			// copy over folder figures from MVD folder
			string nameFiguresSubFolder = "figures"; //GitHub-Pages are cases sentitive, figures ist now lowercase.
			System.IO.Directory.CreateDirectory(System.IO.Path.Combine(path, nameFiguresSubFolder));
			CopyFiles(Properties.Settings.Default.InputPathGeneral, System.IO.Path.Combine(path, nameFiguresSubFolder), overrideExisting: true);

			// copy over static content * if it doesn't already exist *
			string pathContent = System.IO.Path.GetDirectoryName(System.Reflection.Assembly.GetExecutingAssembly().Location);
			if (pathContent.EndsWith(@"bin\x86\Debug") || pathContent.EndsWith(@"bin\x64\Debug")) // debugging
			{
				pathContent = System.IO.Path.GetDirectoryName(pathContent);
				pathContent = System.IO.Path.GetDirectoryName(pathContent);
				pathContent = System.IO.Path.GetDirectoryName(pathContent);
			}
			pathContent = System.IO.Path.Combine(pathContent, "content");

			if (!System.IO.Directory.Exists(path))
			{
				System.IO.Directory.CreateDirectory(path);
			}

			CopyFiles(pathContent, path, overrideExisting:true);

			System.IO.Directory.CreateDirectory(path + "\\diagrams");

			Dictionary<string, DocPropertyEnumeration> mapPropEnum = new Dictionary<string, DocPropertyEnumeration>();
			foreach (DocPropertyEnumeration docEnum in docProject.PropertyEnumerations)
			{
				if (!mapPropEnum.ContainsKey(docEnum.Name))
				{
					mapPropEnum.Add(docEnum.Name, docEnum);
				}
			}

			Dictionary<DocObject, string> mapNumber = new Dictionary<DocObject, string>(); // map items to section (e.g. "1.1.1.1")

			string pathSchema = path + @"\schema";

			// count progress
			int progressTotal = docProject.Sections.Count + docProject.Annexes.Count + 2;
			formProgress.SetProgressTotal(progressTotal);
			worker.ReportProgress(0, "================================================================================");
			worker.ReportProgress(0, docPublication);

			int progressCurrent = 0;


			// build list of locales in use
			SortedList<string, string> listLocale = new SortedList<string, string>();
			foreach (DocObject eachobj in mapEntity.Values)
			{
				if (eachobj.Localization != null)
				{
					foreach (DocLocalization doclocal in eachobj.Localization)
					{
						// only deal with languages, not regions
						if (doclocal.Locale != null && doclocal.Locale.Length >= 2)
						{
							string language = doclocal.Locale.Substring(0, 2);

							if (!listLocale.ContainsKey(language))
							{
								listLocale.Add(language, doclocal.Locale);
							}
						}
					}
				}
			}

			// if publication is limited to specific locales, then customize
			if (docPublication.Localization.Count > 0)
			{
				for (int i = listLocale.Keys.Count - 1; i >= 0; i--)
				{
					string language = listLocale.Keys[i];

					bool langincluded = false;
					for (int j = 0; j < docPublication.Localization.Count; j++)
					{
						if (docPublication.Localization[j].Locale.StartsWith(language))
						{
							langincluded = true;
							break;
						}
					}

					if (!langincluded)
					{
						listLocale.Remove(language);
					}
				}
			}

			string[] locales = new string[listLocale.Count];
			for (int k = 0; k < listLocale.Keys.Count; k++)
			{
				locales[k] = listLocale.Keys[k];
			}

			if (docPublication.ISO)
			{
				// only english translations, so set to NULL
				locales = null;
				listLocale = null;
			}

			// build filter
			Dictionary<DocObject, bool> included = null;
			if (views != null && views.Length > 0)
			{
				included = new Dictionary<DocObject, bool>();
				foreach (DocModelView docEachView in views)
				{
					docProject.RegisterObjectsInScope(docEachView, included);
				}
			}

			Dictionary<DocObject, bool>[] dictionaryViews = new Dictionary<DocObject, bool>[docProject.ModelViews.Count];
			for (int i = 0; i < docProject.ModelViews.Count; i++)
			{
				DocModelView docView = docProject.ModelViews[i];
				if (included != null && included.ContainsKey(docView))
				{
					dictionaryViews[i] = new Dictionary<DocObject, bool>();
					docProject.RegisterObjectsInScope(docProject.ModelViews[i], dictionaryViews[i]);
				}
			}


			DocEntity docEntityRoot = docProject.GetDefinition("IfcRoot") as DocEntity;

			// upper contents page
			string pathHeaderFrame = path + "\\content.html";
			using (FormatHTM htmProp = new FormatHTM(pathHeaderFrame, mapEntity, mapSchema, included))
			{
				string projectname = docPublication.Name, schemaVersion = docProject.GetSchemaVersion();
				if (!string.IsNullOrEmpty(schemaVersion))
				{
					projectname += " - " + schemaVersion;
				}
				if (!String.IsNullOrEmpty(docPublication.Version))
				{
					projectname += " - " + docPublication.Version;
				}
				if (!String.IsNullOrEmpty(docPublication.Status))
				{
					projectname += " [" + docPublication.Status + "]";
				}
				string projectcopy = docPublication.Copyright;

				string coverentry = "<li class=\"std\"><a class=\"listing-link\" href=\"cover.html\" target=\"info\">Cover</a></li>";
				if (docPublication.ISO)
				{
					coverentry = "<li class=\"std\"><a class=\"listing-link\" href=\"index.html\" target=\"top\">Cover</a></li>";
				}

				htmProp.Write(
"<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\r\n" +
"<html lang=\"en\">" +
  "<head>" +
	"<meta http-equiv=\"Content-Type\" content=\"text/html; charset=us-ascii\">" +
	"<link rel=\"STYLESHEET\" href=\"./ifc-styles.css\" type=\"text/css\">" +
  "</head>" +
  "<body class=\"image\">" +
	"<div class=\"content\">" +
	  "<table summary=\"title\" class=\"content\" frameborder=\"0\">" +
		"<tr>" +
		  "<td>" +
			"<p class=\"td\">" +
			  "<b>" + projectname + "</b>" +
			"</p>" +
		  "</td>" +
		  "<td>" +
			"<p class=\"td right\">" +
			  "<b>" + projectcopy + "</b>" +
			"</p>" +
		  "</td>" +
		"</tr>" +
	  "</table>" +
	  "<table summary=\"short table of content\" class=\"content\">" +
		"<col width=\"15%\">" +
		"<col width=\"25%\">" +
		"<col width=\"20%\">" +
		"<col width=\"25%\">" +
		"<col width=\"15%\">" +
		"<tr>" +
		  "<td class=\"content\">" +
			"<ol class=\"td none\">" +
			  coverentry +
			  "<li class=\"std\"><a class=\"listing-link\" href=\"toc.html\" target=\"info\">Contents</a></li>" +
			  "<li class=\"std\"><a class=\"listing-link\" href=\"foreword.html\" target=\"info\">" + docPublication.Annotations[0].Name + "</a></li>" +
			  "<li class=\"std\"><a class=\"listing-link\" href=\"introduction.html\" target=\"info\">" + docPublication.Annotations[1].Name + "</a></li>" +
			"</ol>" +
		  "</td>" +
		  "<td class=\"content\">" +
			"<ol class=\"td num\">" +
			  "<li class=\"std\"><a class=\"listing-link\" href=\"schema/chapter-1.html\" target=\"info\">" + docProject.Sections[0].Name + "</a></li>" +
			  "<li class=\"std\"><a class=\"listing-link\" href=\"schema/chapter-2.html\" target=\"info\">" + docProject.Sections[1].Name + "</a></li>" +
			  "<li class=\"std\"><a class=\"listing-link\" href=\"schema/chapter-3.html\" target=\"info\">" + docProject.Sections[2].Name + "</a></li>" +
			  "<li class=\"std\"><a class=\"listing-link\" href=\"schema/chapter-4.html\" target=\"info\">" + docProject.Sections[3].Name + "</a></li>" +
			"</ol>" +
		  "</td>" +
		  "<td class=\"content\">" +
			"<ol class=\"td num\" start=\"5\">" +
			  "<li class=\"std\"><a class=\"listing-link\" href=\"schema/chapter-5.html\" target=\"info\">" + docProject.Sections[4].Name + "</a></li>" +
			  "<li class=\"std\"><a class=\"listing-link\" href=\"schema/chapter-6.html\" target=\"info\">" + docProject.Sections[5].Name + "</a></li>" +
			  "<li class=\"std\"><a class=\"listing-link\" href=\"schema/chapter-7.html\" target=\"info\">" + docProject.Sections[6].Name + "</a></li>" +
			  "<li class=\"std\"><a class=\"listing-link\" href=\"schema/chapter-8.html\" target=\"info\">" + docProject.Sections[7].Name + "</a></li>" +
			"</ol>" +
		  "</td>" +
		  "<td class=\"content\">" +
			"<ol class=\"td alpha\">" +
			  "<li class=\"std\"><a class=\"listing-link\" href=\"annex/annex-a.html\" target=\"info\">" + docProject.Annexes[0].Name + "</a></li>" +
			  "<li class=\"std\"><a class=\"listing-link\" href=\"annex/annex-b.html\" target=\"info\">" + docProject.Annexes[1].Name + "</a></li>" +
			  "<li class=\"std\"><a class=\"listing-link\" href=\"annex/annex-c.html\" target=\"info\">" + docProject.Annexes[2].Name + "</a></li>" +
			  "<li class=\"std\"><a class=\"listing-link\" href=\"annex/annex-d.html\" target=\"info\">" + docProject.Annexes[3].Name + "</a></li>" +
			"</ol>" +
		  "</td>" +
		  "<td class=\"content\">" +
			"<ol class=\"td alpha\" start=\"5\">" +
			  "<li class=\"std\"><a class=\"listing-link\" href=\"annex/annex-e.html\" target=\"info\">" + docProject.Annexes[4].Name + "</a></li>" +
			  "<li class=\"std\"><a class=\"listing-link\" href=\"annex/annex-f.html\" target=\"info\">" + docProject.Annexes[5].Name + "</a></li>" +
			"</ol>" +
			"<ol class=\"td none\">" +
			  "<li class=\"std\"><a class=\"listing-link\" href=\"bibliography.html\" target=\"info\">Bibliography</a></li>" +
			  "<li class=\"std\"><a class=\"listing-link\" href=\"doc_index.html\" target=\"info\">Index</a></li>" +
			"</ol>" +
		  "</td>" +
		"</tr>" +
	  "</table>" +
	"</div>" +
  "</body>" +
"</html>");
			}

			// cover

			string indexPath = path + "\\index.html";
			if (docPublication.ISO)
			{
				// separate cover page without frame
				System.IO.File.SetAttributes(indexPath, System.IO.FileAttributes.Normal); // strip off read-only flag from copying from source control
				using (FormatHTM htmSection = new FormatHTM(indexPath + "\\index.html", mapEntity, mapSchema, included))
				{
					htmSection.WriteHeader(docPublication.Name, 0, null); // no text for header
					htmSection.WriteLine(docPublication.DocumentationHtml());
					htmSection.WriteFooter(null); // no text for footer
				}
			}
			else
			{
				using (FormatHTM htmSection = new FormatHTM(path + "\\cover.html", mapEntity, mapSchema, included))
				{
					htmSection.WriteHeader(docPublication.Name, 0, docPublication.Header);
                    htmSection.Write(
                     $@"<script type=""text/javascript"">
                        <!--
                            parent.index.location.replace(""credits.html"");
                        //-->
                        </script>
                        <div style=""margin-top: 50px; align: center"">
                          <p>&nbsp;</p>
                          <table style=""margin-left: auto; margin-right: auto; background-repeat: no-repeat; background-image: url(figures/CoverPhoto.png); width: 740px; padding: 20px"">
                            <tbody><tr style=""height: 90px"">
                              <td>&nbsp;</td>
                            </tr>
                            <tr>
                              <td>&nbsp;</td>
                            </tr>
                            <tr style=""height: 320px"">
                              <td style=""vertical-align: top"">
                                <p style=""text-align:left;line-height: 1.8;"" >
                                  <span style=""font-family:Arial, Verdana, Tahoma, sans-serif; font-size:xx-large; color:#17569e; "">
                                    <b>{docPublication.Name}</b></span><br><br><br>
                                  <span style=""font-family:Arial, Verdana, Tahoma, sans-serif; font-size:x-large; color:#17569e; "">
                                    <b>Version {docPublication.Version}</b></span> 
                                </p>
                              </td>
                            </tr>
                            <tr style=""height: 80px"">
                              <td style=""vertical-align: top;"">
                                <p style=""text-align:left;"">
                                  <span style=""font-family:Arial, Verdana, Tahoma, sans-serif; font-size:small; "">
                                    © buildingSMART 1996-{DateTime.Now.Year} - This document is owned and copyrighted by {docPublication.Owner}<br>
                                    By using the IFC4 specification you agree to the following <a href=""copyright.html"" target=""info""><b>copyright notice</b></a></span>
                                </p>
                              </td>
                            </tr>
                          </tbody></table>
                        </div>"
                    );
					htmSection.WriteLine(docPublication.DocumentationHtml());
					htmSection.WriteFooter(docPublication.Footer);
				}
			}

			using (FormatHTM htmSection = new FormatHTM(path + "\\foreword.html", mapEntity, mapSchema, included))
			{
				DocAnnotation docAnnotation = docPublication.Annotations[0];
				htmSection.WriteHeader(docAnnotation.Name, 0, docPublication.Header);
				htmSection.WriteScriptToBlank("");
				htmSection.WriteLine("      <h1 class=\"std\">" + docAnnotation.Name + "</h1>");
				htmSection.WriteLine(docAnnotation.DocumentationHtml());
				htmSection.WriteLinkTo(docPublication, "foreword", 0);
				htmSection.WriteFooter(docPublication.Footer);
			}
			using (FormatHTM htmLink = new FormatHTM(path + "/link/foreword.html", mapEntity, mapSchema, included))
			{
				htmLink.WriteLinkPage("../foreword.html", docPublication);
			}

			using (FormatHTM htmSection = new FormatHTM(path + "\\introduction.html", mapEntity, mapSchema, included))
			{
				DocAnnotation docAnnotation = docPublication.Annotations[1];
				htmSection.WriteHeader(docAnnotation.Name, 0, docPublication.Header);
				htmSection.Write(
					"\r\n" +
					"<script type=\"text/javascript\">\r\n" +
					"<!--\r\n" +
					"    parent.index.location.replace(\"blank.html\");\r\n" +
					"//-->\r\n" +
					"</script>\r\n");

				htmSection.WriteLine("      <h1 class=\"std\">" + docAnnotation.Name + "</h1>");
				htmSection.WriteLine(docAnnotation.DocumentationHtml());
				htmSection.WriteLinkTo(docPublication, "introduction", 0);
				htmSection.WriteFooter(docPublication.Footer);
			}
			using (FormatHTM htmLink = new FormatHTM(path + "/link/introduction.html", mapEntity, mapSchema, included))
			{
				htmLink.WriteLinkPage("../introduction.html", docPublication);
			}

			// NEW: property set index -- build index
			SortedList<string, SortedList<string, DocPropertySet>> mapProperty = new SortedList<string, SortedList<string, DocPropertySet>>();
			foreach (DocSection docSection in docProject.Sections)
			{
				foreach (DocSchema docSchema in docSection.Schemas)
				{
					foreach (DocPropertySet docPset in docSchema.PropertySets)
					{
						if (included == null || included.ContainsKey(docPset))
						{
							if (docPset.IsVisible())
							{
								// include locales
								foreach (DocLocalization doclocal in docPset.Localization)
								{
									// only deal with languages, not regions
									if (doclocal.Locale != null && doclocal.Locale.Length >= 2)
									{
										string language = doclocal.Locale.Substring(0, 2);

										/*
                                        if (!listLocale.ContainsKey(language))
                                        {
                                            listLocale.Add(language, doclocal.Locale);
                                        }*/
									}
								}


								foreach (DocProperty docProp in docPset.Properties)
								{
									string datatype = docProp.PrimaryDataType;
									if (datatype == null)
									{
										datatype = "IfcLabel"; // enumerations
									}

									string match = docProp.Name + " (" + docProp.PropertyType.ToString() + "/" + datatype.ToString() + ")";

									SortedList<string, DocPropertySet> mapPset = null;
									if (!mapProperty.TryGetValue(match, out mapPset))
									{
										mapPset = new SortedList<string, DocPropertySet>();
										mapProperty.Add(match, mapPset);
									}

									mapPset.Add(docPset.Name, docPset);


									// include locales
									/*
                                    foreach (DocLocalization doclocal in docProp.Localization)
                                    {
                                        // only deal with languages, not regions
                                        if (doclocal.Locale != null && doclocal.Locale.Length >= 2)
                                        {
                                            string language = doclocal.Locale.Substring(0, 2);

                                            if (!listLocale.ContainsKey(language))
                                            {
                                                listLocale.Add(language, doclocal.Locale);
                                            }
                                        }
                                    }
                                    */
								}
							}
						}
					}
				}
			}

			// now format listing of properties
			StringBuilder sbProperties = new StringBuilder();
			foreach (string nameProp in mapProperty.Keys)
			{
				sbProperties.Append("<li>");
				sbProperties.Append(nameProp);

				sbProperties.Append("<ul>");
				SortedList<string, DocPropertySet> mapPset = mapProperty[nameProp];

				foreach (DocPropertySet pset in mapPset.Values)
				{
					if (pset.IsVisible())
					{
						string proplinkurl = "../../schema/" + mapSchema[pset.Name].ToLower() + "/pset/" + pset.Name.ToLower() + ".html";

						sbProperties.Append("&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;");
						sbProperties.Append("<a class=\"listing-link\" href=\"");
						sbProperties.Append(proplinkurl);
						sbProperties.Append("\">");
						sbProperties.Append(pset.Name);
						sbProperties.Append("</a><br/>");
					}
				}

				sbProperties.Append("</ul></li>");
			}
			string pathProps = path + @"/annex/annex-b/alphabeticalorder_properties.html";
			using (FormatHTM htmProp = new FormatHTM(pathProps, mapEntity, mapSchema, included))
			{
				htmProp.WriteHeader("Properties", 2, docPublication.Header);

				htmProp.WriteLine("<h2 class=\"annex\">Individual Properties (" + mapProperty.Count + ")</h2>");
				htmProp.WriteLine("<ul class=\"std\">");

				htmProp.WriteLine(sbProperties.ToString());

				htmProp.WriteLine("</ul>");

				htmProp.WriteFooter(docPublication.Footer);
			}

			// capture figures and tables
			List<ContentRef> listFigures = new List<ContentRef>();
			List<ContentRef> listTables = new List<ContentRef>();

			// NEW: section 4 templates
			int iTemplate = 0;
			foreach (DocTemplateDefinition docTemplate in docProject.Templates)
			{
				if (included == null || included.ContainsKey(docTemplate))
				{
					iTemplate++;
					int[] indexpath = new int[] { 4, iTemplate };
					GenerateTemplate(docProject, docTemplate, mapEntity, mapSchema, included, indexpath, listFigures, listTables, docPublication, path);
				}
			}

			string pathTOC = path + @"\toc.html";
			using (FormatHTM htmTOC = new FormatHTM(pathTOC, mapEntity, mapSchema, included))
			{
				htmTOC.WriteHeader("Contents", 0, docPublication.Header);

				htmTOC.WriteLine("    <script type=\"text/javascript\">");
				htmTOC.WriteLine("        <!--");
				htmTOC.WriteLine("        parent.index.location = \"blank.html\";");
				htmTOC.WriteLine("        parent.menu.location = \"content.html\"");
				htmTOC.WriteLine("        -->");
				htmTOC.WriteLine("    </script>");

				htmTOC.WriteLine("      <h1 class=\"std\">Contents</h1>");

				htmTOC.WriteLine("<p>");

				foreach (DocPropertyEnumeration entity in docProject.PropertyEnumerations)
				{
					if (worker.CancellationPending)
						return null;

					if (included == null || included.ContainsKey(entity))
					{
					//	string formatnum = ??"B.1.9";
					//	mapNumber.Add(entity, formatnum);

						using (FormatHTM htmDef = new FormatHTM(path + "\\penum\\" + entity.Name.ToLower() + ".html", mapEntity, mapSchema, included))
						{
							htmDef.WriteHeader(entity.Name, 1, docPublication.Header);
							htmDef.WriteScriptToBlank("../");
							htmDef.WriteLine("<h4 class=\"std\">" + entity.Name + "</h4>");

							// english by default
							htmDef.WriteLocalizationSection(entity, locales, docPublication);
							htmDef.WriteChangeLog(entity, listChangeSets, docPublication);

							htmDef.WriteSummaryHeader("Constants", true, docPublication);
							htmDef.WriteLine("<table class=\"gridtable\">");
							htmDef.WriteLine("<tr><th>Name</th><th>Description</th></tr>");
							foreach (DocPropertyConstant docprop in entity.Constants)
							{
								htmDef.WriteLine("<tr><td>" + docprop.Name + "</td><td>");
								htmDef.WriteLocalizationTable(docprop, locales, "../");
								htmDef.WriteLine("</td></tr>");
							}
							htmDef.WriteLine("</table>");
							htmDef.WriteSummaryFooter(docPublication);

							// write url for incoming page link
							htmDef.WriteLinkTo(docProject, docPublication, entity);

							htmDef.WriteFooter(docPublication.Footer);
						}
					}
				}


				// each section
				int iSection = 0;
				foreach (DocSection section in docProject.Sections)
				{
					worker.ReportProgress(++progressCurrent, section);
					if (worker.CancellationPending)
						return null;

					iSection++;
					using (FormatHTM htmSectionTOC = new FormatHTM(pathSchema + @"\toc-" + iSection.ToString() + ".html", mapEntity, mapSchema, included))
					{

						htmSectionTOC.WriteLine(
							"<html> \r\n" +
							"<head> \r\n" +
							"<meta http-equiv=\"Content-Type\" content=\"text/html; charset=UTF-8\"> \r\n" +
							"<link rel=\"stylesheet\" type=\"text/css\" href=\"../ifc-styles.css\"> \r\n" +
							"<title>Section Contents</title> \r\n" +
							"</head> \r\n" +
							"<body class=\"image\"> \r\n" +
							"<div class=\"menu\">\r\n" +
							"<table class=\"menu\" summary=\"Table of Contents\">\r\n");

						htmTOC.WriteTOC(0, "<a class=\"listing-link\" href=\"schema/chapter-" + iSection.ToString() + ".html\">" + iSection.ToString() + ". " + section.Name + "</a>");

						mapNumber.Add(section, iSection.ToString() + ".");

						htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">" + iSection + ". <a class=\"listing-link\" href=\"chapter-" + iSection + ".html\" target=\"info\" >" + section.Name + "</a></td></tr>\r\n");

						// write the section page
						using (FormatHTM htmSection = new FormatHTM(pathSchema + @"\chapter-" + iSection.ToString() + @".html", mapEntity, mapSchema, included))
						{
							htmSection.WriteHeader(section.Name, iSection - 1, 0, 0, 0, docPublication.Header);
							htmSection.WriteScript(iSection, 0, 0, 0);
							htmSection.WriteLine("<h1 class=\"num\" id=\"scope\">" + section.Name + "</h1>");

							string documentation = UpdateNumbering(section.DocumentationHtml(), listFigures, listTables, section);
							htmSection.WriteDocumentationMarkup(documentation, section, docPublication, path);


							if (iSection == 1)
							{
								if (docPublication.Exchanges)
								{
									htmSection.Write("<table class=\"gridtable\">");
									htmSection.Write("<tr><th>Format</th><th>Description</th></tr>");
									htmSection.Write("<tr><td>Tab-delimited</th><td><a href=\"..\\infobase.csv\">infobase.csv</a></td></tr>");
									htmSection.Write("</table>");
								}

								string delim = ",";
								StringBuilder sb = new StringBuilder();

								//string viewtable = FormatView(docProject, docPublication, null, mapEntity, mapSchema, sbData);
								//htmSection.WriteDocumentationMarkup(viewtable, section, docPublication);

								List<DocModelView> listGraphView = new List<DocModelView>();
								foreach (DocModelView docView in docPublication.Views)
								{
									BuildViewList(docProject, listGraphView, docView);
								}


								List<DocModelView> listView = new List<DocModelView>();
								List<DocExchangeDefinition> listExchange = new List<DocExchangeDefinition>();
								foreach (DocModelView docView in listGraphView)
								{
									foreach (DocExchangeDefinition docExchange in docView.Exchanges)
									{
										if (!String.IsNullOrEmpty(docExchange.Code))
										{
											listView.Add(docView);
											listExchange.Add(docExchange);
										}
									}
								}

								// header
								sb.Append("IFC");
								foreach (DocExchangeDefinition docExchange in listExchange)
								{
									sb.Append(delim + docExchange.Code);
								}
								sb.AppendLine();

								foreach (DocSection docSection in docProject.Sections)
								{
									foreach (DocSchema docSchema in docSection.Schemas)
									{
										foreach (DocEntity docEntity in docSchema.Entities)
										{
											// track the first unique item using a mapping
											List<DocTemplateItem> listItems = new List<DocTemplateItem>();
											List<DocTemplateUsage> listUsage = new List<DocTemplateUsage>();

											// correlate first item with exchanges that include item and any related ones
											Dictionary<DocTemplateItem, List<DocModelView>> mapView = new Dictionary<DocTemplateItem, List<DocModelView>>();

											foreach (DocModelView docEachView in listView)
											{
												foreach (DocConceptRoot docRoot in docEachView.ConceptRoots)
												{
													if (docRoot.ApplicableEntity == docEntity && !docRoot.IsDeprecated())
													{
														foreach (DocTemplateUsage docConcept in docRoot.Concepts)
														{
															if (docConcept.Definition != null && docConcept.Definition.Uuid == DocTemplateDefinition.guidTemplateMapping)
															{
																foreach (DocTemplateItem docItem in docConcept.Items)
																{
																	string refItem = docItem.GetParameterValue("Reference");

																	// is it already define?
																	bool add = true;
																	foreach (DocTemplateItem docExist in listItems)
																	{
																		string refExist = docExist.GetParameterValue("Reference");
																		if (refItem == refExist)
																		{
																			// already there
																			add = false;
																			if (!mapView.ContainsKey(docExist))
																			{
																				mapView.Add(docExist, new List<DocModelView>());
																			}
																			mapView[docExist].Add(docEachView);

																			break;
																		}
																	}

																	if (add)
																	{
																		listItems.Add(docItem);
																		listUsage.Add(docConcept);

																		if (!mapView.ContainsKey(docItem))
																		{
																			mapView.Add(docItem, new List<DocModelView>());
																		}
																		mapView[docItem].Add(docEachView);
																	}
																}
															}
														}
													}
												}
											}

											if (listItems.Count > 0)
											{
												for (int iItem = 0; iItem < listItems.Count; iItem++)
												{
													DocTemplateItem docItem = listItems[iItem];
													DocTemplateUsage docUsage = listUsage[iItem];

													//string name = docItem.GetParameterValue("Name");
													string refv = docItem.GetParameterValue("Reference");
													if (!String.IsNullOrEmpty(refv))
													{
														sb.Append(refv);

														for (int iExchange = 0; iExchange < listExchange.Count; iExchange++)
														{
															sb.Append(delim);

															// check if exchange is referenced
															DocExchangeDefinition docExchange = listExchange[iExchange];
															DocModelView docView = listView[iExchange];
															DocTemplateItem docRefItem = CheckForReference(docProject, docView, docExchange, refv);

															if (docRefItem != null)
															{
																string reftab = docItem.GetParameterValue("Table");
																string refcol = docItem.GetParameterValue("Name");
																sb.Append(reftab + "." + refcol);
															}
														}

														sb.AppendLine();
													}
												}
											}
										}
									}
								}

								using (FileStream fs = new FileStream(path + @"\infobase.csv", FileMode.Create))
								{
									using (StreamWriter w = new StreamWriter(fs, Encoding.ASCII))
									{
										w.Write(sb.ToString());
									}
								}


								// model view definitions -- only show those explicitly referenced -- will inherit content as needed
								int iView = 0;
								//foreach (DocModelView docProjectModelView in docProject.ModelViews)
								foreach (DocModelView docProjectModelView in docPublication.Views)
								{
									//if (included == null || included.ContainsKey(docProjectModelView))
									if (!docProjectModelView.IsDeprecated())
									{
										iView++;
										int[] indexpath = new int[] { 1, iView };

										htmSectionTOC.WriteLine("<tr><td>&nbsp;</td></tr>"); // extra separation at top level

										GenerateView(docProject, docPublication, docProjectModelView, mapEntity, mapSchema, included, indexpath, path, htmTOC, htmSectionTOC);
									}
								}
							}
							else if (iSection == 2)
							{
								htmSection.WriteLine("<dl>");
								if (docProject.NormativeReferences != null)
								{
									foreach (DocReference docRef in docProject.NormativeReferences)
									{
										htmSection.WriteLine("<dt class=\"normativereference\"><a id=\"" + MakeLinkName(docRef) + "\">" + docRef.Name + "</a>, <i>" + docRef.DocumentationHtml() + "</i></dt>");
										htmSection.WriteLine("<dd>&nbsp;</dd>");
									}
								}
								htmSection.WriteLine("</dl>");
							}
							else if (iSection == 3)
							{
								htmTOC.WriteTOC(0, "<a class=\"listing-link\" href=\"schema/chapter-3.html#terms\">3.1 Terms and definitions</a>");
								htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">3.1 <a class=\"listing-link\" href=\"chapter-3.html#terms\" target=\"info\" >Terms and definitions</a></td></tr>\r\n");

								htmTOC.WriteTOC(0, "<a class=\"listing-link\" href=\"schema/chapter-3.html#abbreviated\">3.2 Abbreviated terms</a>");
								htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">3.2 <a class=\"listing-link\" href=\"chapter-3.html#abbreviated\" target=\"info\" >Abbreviated terms</a></td></tr>\r\n");

								htmSection.WriteLine("<a id=\"terms\"/>");
								htmSection.WriteLine("<h2>3.1 Terms and definitions</h2>");
								htmSection.WriteLine("<dl>");
								if (docProject.Terms != null)
								{
									int[] indexpath = new int[] { 3, 1, 0 };
									foreach (DocTerm docTerm in docProject.Terms)
									{
										indexpath[2]++;
										htmSection.WriteTerm(docTerm, indexpath);
									}
								}
								htmSection.WriteLine("</dl>");
								htmSection.WriteLine("<a id=\"abbreviated\"/>");
								htmSection.WriteLine("<h2>3.2 Abbreviated terms</h2>");
								htmSection.WriteLine("<table class=\"abbreviatedterms\">");
								if (docProject.Abbreviations != null)
								{
									SortedList<string, DocAbbreviation> sl = new SortedList<string, DocAbbreviation>();
									foreach (DocAbbreviation docRef in docProject.Abbreviations)
									{
										sl.Add(docRef.Name, docRef);
									}

									foreach (string s in sl.Keys)
									{
										DocAbbreviation docRef = sl[s];
										htmSection.WriteLine("<tr><td class=\"abbreviatedterm\" id=\"" + MakeLinkName(docRef) + "\">" + docRef.Name + "</td>");
										htmSection.WriteLine("<td class=\"abbreviatedterm\">" + docRef.DocumentationHtmlNoParagraphs() + "</td></tr>");
									}
								}
								htmSection.WriteLine("</table>");
							}
							else if (iSection == 4)
							{
								FormatHTM.WriteTOCforTemplates(docProject.Templates, 1, iSection.ToString(), htmTOC, htmSectionTOC, included);

								// (a) full templates
								htmSection.WriteSummaryHeader("Concept templates", true, docPublication);
								htmSection.WriteLine("<table class=\"gridtable\">");
								htmSection.WriteLine("<tr><th>Template</th>");
								for (int i = 0; i < docProject.ModelViews.Count; i++)
								{
									DocModelView docView = docProject.ModelViews[i];
									if (included != null && included.ContainsKey(docView))
									{
										htmSection.WriteLine("<th>" + docProject.ModelViews[i].Name + "</th>");
									}
								}
								htmSection.WriteLine("</tr>");
								foreach (DocTemplateDefinition docTemplateDefinition in docProject.Templates)
								{
									if (!String.IsNullOrEmpty(docTemplateDefinition.Type))
									{
										htmSection.WriteTemplateTable(docProject, docTemplateDefinition, 0, dictionaryViews);
									}
								}
								htmSection.WriteLine("</table>");
								htmSection.WriteSummaryFooter(docPublication);

								htmSection.WriteLine("<p>");

								// (b) partial templates
								htmSection.WriteSummaryHeader("Partial templates in use", true, docPublication);
								htmSection.WriteLine("<table class=\"gridtable\">");
								htmSection.WriteLine("<tr><th>Template</th>");
								for (int i = 0; i < docProject.ModelViews.Count; i++)
								{
									DocModelView docView = docProject.ModelViews[i];
									if (included != null && included.ContainsKey(docView))
									{
										htmSection.WriteLine("<th>" + docProject.ModelViews[i].Name + "</th>");
									}
								}
								htmSection.WriteLine("</tr>");
								foreach (DocTemplateDefinition docTemplateDefinition in docProject.Templates)
								{
									if (String.IsNullOrEmpty(docTemplateDefinition.Type))
									{
										htmSection.WriteTemplateTable(docProject, docTemplateDefinition, 0, dictionaryViews);
									}
								}
								htmSection.WriteLine("</table>");
								htmSection.WriteSummaryFooter(docPublication);

							}

							htmSection.WriteLine("<p>");

							int iListSchema = 0;
							foreach (DocSchema schema in section.Schemas)
							{
								if (included == null || included.ContainsKey(schema))
								{
									iListSchema++;
									htmSection.WriteLine("<a class=\"listing-link\" href=\"" + schema.Name.ToLower() + "/content.html\">" + iSection.ToString() + "." + iListSchema.ToString() + " " + schema.Name + "</a><br>");
								}
							}
							htmSection.WriteLine("</p>");

							htmSection.WriteLinkTo(docPublication, "chapter-" + iSection, 1);

							htmSection.WriteFooter(docPublication.Footer);
						}

						
						// each schema
						int iSchema = 0;
						foreach (DocSchema schema in section.Schemas)
						{
							if (worker.CancellationPending)
								return null;

							if (included == null || included.ContainsKey(schema))
							{
								iSchema++;

								// ensure directory exists
								System.IO.Directory.CreateDirectory(pathSchema + @"\" + schema.Name.ToLower() + @"\lexical\");

								// create schema document
								using (FormatHTM htmSchema = new FormatHTM(pathSchema + @"\" + schema.Name.ToLower() + @"\content.html", mapEntity, mapSchema, included))
								{
									{
										mapNumber.Add(schema, iSection.ToString() + "." + iSchema.ToString());

										htmTOC.WriteTOC(1, "<a class=\"listing-link\" href=\"schema/" + schema.Name.ToLower() + "/content.html\">" + iSection.ToString() + "." + iSchema.ToString() + " " + schema.Name + "</a>");

										// extra line between each schema
										htmSectionTOC.WriteLine("<tr><td>&nbsp;</td></tr>");
										htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\"><a id=\"" + iSection.ToString() + "." + iSchema.ToString() + "\">" + iSection.ToString() + "." + iSchema.ToString() + "</a> <a class=\"listing-link\" href=\"" + schema.Name.ToLower() + "/content.html\" target=\"info\">" + schema.Name + "</a></td></tr>\r\n");

										htmSchema.WriteHeader(schema.Name, iSection, iSchema, 0, 0, docPublication.Header);

										htmSchema.WriteScript(iSection, iSchema, 0, 0);

										htmSchema.WriteLine("<h2 class=\"std\">" + iSection.ToString() + "." + iSchema.ToString() + " " + schema.Name + "</h2>");

										int iSubSection = 1; // first subsection for schema semantic definition
										htmTOC.WriteTOC(2, iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + " Schema Definition");
										htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">" + iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + " Schema Definition</td></tr>\r\n");
										htmSchema.WriteLine("<h3 class=\"std\">" + iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + " Schema Definition</h3>");

										string documentation = UpdateNumbering(schema.DocumentationHtml(), listFigures, listTables, schema);
										htmSchema.WriteDocumentationMarkup(documentation, schema, docPublication, path);

										// each type
										if (schema.Types.Count > 0)
										{
											iSubSection++;

											htmTOC.WriteTOC(2, iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + " Types");
											htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">" + iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + " Types</td></tr>\r\n");
											int iType = 0;
											foreach (DocType type in schema.Types)
											{
												if (worker.CancellationPending)
													return null;

												if (type.Name.Equals("IfcNullStyle", StringComparison.OrdinalIgnoreCase) && schema.Name.Equals("IfcConstructionMgmtDomain", StringComparison.OrdinalIgnoreCase))
												{
													// bug -- exclude
												}
												else if (included == null || included.ContainsKey(type))
												{
													iType++;

													string formatnum = iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + "." + iType.ToString();
													mapNumber.Add(type, formatnum);

													htmTOC.WriteTOC(3, "<a class=\"listing-link\" href=\"schema/" + mapSchema[type.Name].ToLower() + "/lexical/" + type.Name.ToLower() + ".html\">" + formatnum.ToString() + " " + type.Name + "</a>");
													htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\"><a id=\"" + formatnum + "\">" + iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + "." + iType.ToString() + "</a> <a class=\"listing-link\" href=\"" + mapSchema[type.Name].ToLower() + "/lexical/" + type.Name.ToLower() + ".html\" target=\"info\">" + type.Name + "</a><td></tr>\r\n");


													using (FormatHTM htmDef = new FormatHTM(pathSchema + @"\" + schema.Name.ToLower() + "\\lexical\\" + type.Name.ToLower() + ".html", mapEntity, mapSchema, included))
													{
														htmDef.WriteHeader(type.Name, iSection, iSchema, iSubSection, iType, docPublication.Header);

														htmDef.WriteScript(iSection, iSchema, iSubSection, iType);

														htmDef.WriteLine("<h4 class=\"num\">" + type.Name + "</h4>");

														if (!docPublication.ISO)
														{
															htmDef.WriteViewIcons(type, docProject, dictionaryViews, path);
														}
														htmDef.WriteLocalizationSection(type, locales, docPublication);

														htmDef.WriteChangeLog(type, listChangeSets, docPublication);
														htmDef.WriteLine("<section>");
														htmDef.WriteLine("<h5 class=\"num\">Semantic definitions at the type</h5>");

														documentation = UpdateNumbering(type.DocumentationHtml(), listFigures, listTables, type);

														htmDef.WriteSummaryHeader("Type definition", true, docPublication);
														htmDef.WriteDocumentationMarkup(documentation, type, docPublication, path);
														htmDef.WriteSummaryFooter(docPublication);

														if (type is DocEnumeration)
														{
															DocEnumeration docEnumeration = (DocEnumeration)type;

															htmDef.WriteSummaryHeader("Enumeration definition", true, docPublication);
															htmDef.WriteLine("<table class=\"attributes\">");
															htmDef.WriteLine("<tr><th>Constant</th><th>Description</th></tr>");
															foreach (DocConstant docConstant in docEnumeration.Constants)
															{
																htmDef.Write("<tr><td>");
																htmDef.Write(docConstant.Name);
																htmDef.Write("</td><td>");
																htmDef.Write(docConstant.DocumentationHtmlNoParagraphs());
																htmDef.Write("</td></tr>");
															}
															htmDef.WriteLine("</table>");
															htmDef.WriteSummaryFooter(docPublication);
														}
														else if (type is DocSelect)
														{
															DocSelect docSelect = (DocSelect)type;

															htmDef.WriteSummaryHeader("Select definition", true, docPublication);
															htmDef.WriteLine("<table class=\"attributes\">");
															htmDef.WriteLine("<tr><th>Type</th><th>Description</th></tr>");
															foreach (DocSelectItem docSelectItem in docSelect.Selects)
															{
																DocObject docRef = null;
																if (mapEntity.TryGetValue(docSelectItem.Name, out docRef))
																{
																	if (included == null || included.ContainsKey(docRef))
																	{
																		htmDef.Write("<tr><td>");
																		htmDef.WriteDefinition(docSelectItem.Name);
																		//htmDef.Write(docSelectItem.Name);
																		htmDef.Write("</td><td>");
																		htmDef.Write(docSelectItem.DocumentationHtmlNoParagraphs());
																		htmDef.Write("</td></tr>");
																	}
																}
															}
															htmDef.WriteLine("</table>");
															htmDef.WriteSummaryFooter(docPublication);
														}

														htmDef.WriteLine("</section>");


														// where rules (for defined types)

														if (type is DocDefined && ((DocDefined)type).WhereRules != null && ((DocDefined)type).WhereRules.Count > 0)
														{
															DocDefined entity = (DocDefined)type;

															// formal propositions
															htmDef.WriteSummaryHeader("Formal Propositions", true, docPublication);

															htmDef.WriteLine("<table class=\"propositions\">");
															htmDef.WriteLine("<tr><th>Rule</th><th>Description</th></tr>");
															foreach (DocWhereRule docAttr in entity.WhereRules)
															{
																htmDef.Write("<tr><td>");
																htmDef.Write(docAttr.Name);
																htmDef.Write("</td><td>");
																if (docAttr.Documentation != null)
																{
																	htmDef.WriteDocumentationMarkup(docAttr.DocumentationHtmlNoParagraphs(), entity, docPublication, path);
																}
																htmDef.WriteLine("</td></tr>");
															}
															htmDef.WriteLine("</table>\r\n");

															htmDef.WriteSummaryFooter(docPublication);
														}



														htmDef.WriteLine("<section>");
														htmDef.WriteLine("<h5 class=\"num\">Formal representations</h5>");

														foreach (DocFormat docFormat in docPublication.Formats)
														{
															if (docFormat.FormatOptions != DocFormatOptionEnum.None)
															{
																// future: componentize all formats
																IFormatExtension formatext = null;
																mapFormatSchema.TryGetValue(docFormat.FormatType, out formatext);
																switch (docFormat.FormatType)
																{
																	case DocFormatSchemaEnum.STEP:
																		htmDef.WriteExpressTypeAndDocumentation(type, !docPublication.HideHistory, docPublication);
																		break;

																	default:
																		if (formatext != null)
																		{
																			string output = null;
																			if (type is DocSelect)
																			{
																				output = formatext.FormatSelect((DocSelect)type, mapEntity, included);
																			}
																			else if (type is DocEnumeration)
																			{
																				output = formatext.FormatEnumeration((DocEnumeration)type, mapEntity, included);
																			}
																			else if (type is DocDefined)
																			{
																				output = formatext.FormatDefined((DocDefined)type, mapEntity, included);
																			}
																			if (output != null)
																			{
																				htmDef.WriteSummaryHeader(docFormat.FormatType.ToString() + " Specification", false, docPublication);
																				htmDef.Write("<div class=\"xsd\"><code class=\"xsd\">");
																				htmDef.WriteExpression(output, "../../");
																				htmDef.Write("</code></div>");
																				htmDef.WriteSummaryFooter(docPublication);
																			}
																		}
																		break;
																}
															}
														}

														htmDef.WriteLine("</section>");

														// write url for incoming page link
														htmDef.WriteLinkTo(docProject, docPublication, type);

														htmDef.WriteFooter(docPublication.Footer);
													}
												}
											}

										}

										// each entity
										if (schema.Entities.Count > 0)
										{
											iSubSection++;

											htmTOC.WriteTOC(2, iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + " Entities");
											htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">" + iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + " Entities</td></tr>\r\n");
											int iEntity = 0;
											foreach (DocEntity entity in schema.Entities)
											{
												if (worker.CancellationPending)
													return null;

												if (included == null || included.ContainsKey(entity))
												{
													iEntity++;

													string formatnum = iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + "." + iEntity.ToString();
													mapNumber.Add(entity, formatnum);

													htmTOC.WriteTOC(3, "<a class=\"listing-link\" href=\"schema/" + mapSchema[entity.Name].ToLower() + "/lexical/" + entity.Name.ToLower() + ".html\">" + formatnum + " " + entity.Name + "</a>");
													htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\"><a id=\"" + formatnum + "\">" + iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + "." + iEntity.ToString() + "</a> <a class=\"listing-link\" href=\"" + mapSchema[entity.Name].ToLower() + "/lexical/" + entity.Name.ToLower() + ".html\" target=\"info\">" + entity.Name + "</a></td></tr>\r\n");

													using (FormatHTM htmDef = new FormatHTM(pathSchema + @"\" + schema.Name.ToLower() + "\\lexical\\" + entity.Name.ToLower() + ".html", mapEntity, mapSchema, included))
													{
														htmDef.WriteHeader(entity.Name, iSection, iSchema, iSubSection, iEntity, docPublication.Header);
														htmDef.WriteScript(iSection, iSchema, iSubSection, iEntity);

														htmDef.WriteLine("<h4 class=\"num\">" + entity.Name + "</h4>");

														if (!docPublication.ISO)
														{
															htmDef.WriteViewIcons(entity, docProject, dictionaryViews, path);
														}
														htmDef.WriteLocalizationSection(entity, locales, docPublication);
														htmDef.WriteChangeLog(entity, listChangeSets, docPublication);

														htmDef.WriteLine("<section>");
														htmDef.WriteLine("<h5 class=\"num\">Semantic definitions at the entity</h5>");

														string entitydocumentation = FormatEntityDescription(docProject, entity, listFigures, listTables);

														htmDef.WriteSummaryHeader("Entity definition", true, docPublication);
														htmDef.WriteDocumentationMarkup(entitydocumentation, entity, docPublication, path);
														htmDef.WriteSummaryFooter(docPublication);

														if (entity.Attributes != null && entity.Attributes.Count > 0)
														{
															htmDef.WriteSummaryHeader("Attribute definitions", true, docPublication);

															htmDef.WriteLine("<table class=\"attributes\">");
															htmDef.WriteLine("<tr><th>#</th><th>Attribute</th><th>Type</th><th>Cardinality</th><th>Description</th>");

															if (views != null)
															{
																foreach (DocModelView docViewHeader in views)
																{
																	htmDef.Write("<th>");
																	htmDef.Write(docViewHeader.Name.Substring(0, 1));
																	htmDef.Write("</th>");
																}
															}
															htmDef.WriteLine("</tr>");

															int sequence = 0;

															// count direct attributes of base classes
															DocEntity docEntBase = entity;
															DocObject docBase = null;
															while (!String.IsNullOrEmpty(docEntBase.BaseDefinition) && mapEntity.TryGetValue(docEntBase.BaseDefinition, out docBase))
															{
																docEntBase = (DocEntity)docBase;
																foreach (DocAttribute docAttrBase in docEntBase.Attributes)
																{
																	if (docAttrBase.Inverse == null && docAttrBase.Derived == null)
																	{
																		sequence++;
																	}
																}
															}

															htmDef.WriteEntityAttributes(entity, entity, views, dictionaryViews, docPublication, path, ref sequence);

															htmDef.WriteLine("</table>");

															htmDef.WriteSummaryFooter(docPublication);
														}

														if (entity.WhereRules != null && entity.WhereRules.Count > 0)
														{
															// avoid attributes without descriptions
															int cDescs = 0;
															foreach (DocWhereRule docAttr in entity.WhereRules)
															{
																if (docAttr.Documentation != null)
																{
																	cDescs++;
																}
															}

															if (cDescs > 0)
															{
																// formal propositions
																htmDef.WriteSummaryHeader("Formal Propositions", true, docPublication);

																htmDef.WriteLine("<table class=\"propositions\">");
																htmDef.WriteLine("<tr><th>Rule</th><th>Description</th></tr>");
																foreach (DocWhereRule docAttr in entity.WhereRules)
																{
																	htmDef.Write("<tr><td>");
																	htmDef.Write(docAttr.Name);
																	htmDef.Write("</td><td>");
																	if (docAttr.Documentation != null)
																	{
																		htmDef.WriteDocumentationMarkup(docAttr.DocumentationHtmlNoParagraphs(), entity, docPublication, path);
																	}
																	htmDef.WriteLine("</td></tr>");
																}
																htmDef.WriteLine("</table>\r\n");

																htmDef.WriteSummaryFooter(docPublication);
															}
														}

														htmDef.WriteLine("</section>");

														if (!docPublication.ISO)
														{
															htmDef.WriteLine("<section>");
															htmDef.WriteLine("<h5 class=\"num\">Inherited definitions from supertypes</h5>");

															Dictionary<Rectangle, DocEntity> map = new Dictionary<Rectangle, DocEntity>();
															using (Font font = new Font(FontFamily.GenericSansSerif, 8.0f))
															{
																using (Image img = FormatPNG.CreateInheritanceDiagramForEntity(docProject, included, entity, font, map))
																{
																	try
																	{
																		img.Save(path + "\\diagrams\\" + entity.Name.ToLower() + ".png", System.Drawing.Imaging.ImageFormat.Png);
																	}
																	catch
																	{
																		img.ToString();
																	}
																}
															}

															htmDef.WriteSummaryHeader("Entity inheritance", true, docPublication);
															htmDef.WriteLine("<img src=\"../../../diagrams/" + entity.Name.ToLower() + ".png\" usemap=\"#f\"/>");

															htmDef.WriteLine("<map name=\"f\">");
															foreach (Rectangle rc in map.Keys)
															{
																DocEntity docEntref = map[rc];
																DocSchema docEntsch = docProject.GetSchemaOfDefinition(docEntref);

																string hyperlink = "../../../schema/" + docEntsch.Name.ToLower() + "/lexical/" + docEntref.Name.ToLower() + ".html";
																htmDef.WriteLine("<area shape=\"rect\" coords=\"" + rc.Left + "," + rc.Top + "," + rc.Right + "," + rc.Bottom + "\" href=\"" + hyperlink + "\" alt=\"" + docEntref.Name + "\" />");
															}
															htmDef.WriteLine("</map>");

															htmDef.WriteSummaryFooter(docPublication);

															htmDef.WriteSummaryHeader("Attribute inheritance", false, docPublication);

															htmDef.WriteLine("<table class=\"attributes\">");
															htmDef.Write("<tr><th>#</th><th>Attribute</th><th>Type</th><th>Cardinality</th><th>Description</th>");
															if (views != null)
															{
																foreach (DocModelView docViewHeader in views)
																{
																	htmDef.Write("<th>");
																	htmDef.Write(docViewHeader.Name.Substring(0, 1));
																	htmDef.Write("</th>");
																}
															}
															htmDef.WriteLine("</tr>");

															int sequenceX = 0;
															htmDef.WriteEntityInheritance(entity, entity, views, dictionaryViews, docPublication, path, ref sequenceX);

															htmDef.WriteLine("</table>");

															htmDef.WriteSummaryFooter(docPublication);
															htmDef.WriteLine("</section>");
														}

														string conceptdocumentation = FormatEntityConcepts(docProject, entity, mapEntity, mapSchema, included, listFigures, listTables, path, docPublication);
														//htmDef.WriteLine(conceptdocumentation);
														htmDef.WriteDocumentationMarkup(conceptdocumentation, entity, docPublication, path);

														if (docProject.Examples != null)
														{
															List<DocExample> listExample = new List<DocExample>();
															foreach (DocExample docExample in docProject.Examples)
															{
																BuildExampleList(listExample, docExample, entity, included);
															}
															if (listExample.Count > 0)
															{
																htmDef.WriteLine("<section>");
																htmDef.WriteLine("<h5 class=\"num\">Examples</h5>");
																htmDef.WriteLine("<ul>");
																foreach (DocExample docExample in listExample)
																{
																	if (docExample.Name != null)
																	{
																		htmDef.Write("<li><a href=\"../../../annex/annex-e/");
																		htmDef.Write(docExample.Name.Replace(' ', '-').ToLower());
																		htmDef.Write(".html\">");
																		htmDef.Write(docExample.Name);
																		htmDef.Write("</a></li>");
																		htmDef.WriteLine("");
																	}
																}
																htmDef.WriteLine("</ul>");
																htmDef.WriteLine("</section>");
															}
														}

														htmDef.WriteLine("<section>");
														htmDef.WriteLine("<h5 class=\"num\">Formal representations</h5>");

														foreach (DocFormat docFormat in docPublication.Formats)
														{
															if (docFormat.FormatOptions != DocFormatOptionEnum.None)
															{
																// future: componentize all formats
																IFormatExtension formatext = null;
																mapFormatSchema.TryGetValue(docFormat.FormatType, out formatext);
																switch (docFormat.FormatType)
																{
																	case DocFormatSchemaEnum.STEP:
																		htmDef.WriteExpressEntitySpecification(entity, !docPublication.HideHistory, docPublication);
																		break;

																	default:
																		if (formatext != null)
																		{
																			string output = formatext.FormatEntity(entity, mapEntity, included);
																			if (output != null)
																			{
																				htmDef.WriteSummaryHeader(docFormat.FormatType.ToString() + " Specification", false, docPublication);
																				htmDef.Write("<div class=\"xsd\"><code class=\"xsd\">");
																				htmDef.WriteExpression(output, "../../");
																				htmDef.Write("</code></div>");
																				htmDef.WriteSummaryFooter(docPublication);
																			}
																		}
																		break;
																}
															}
														}

														htmDef.WriteLine("</section>");

														// write url for incoming page link
														htmDef.WriteLinkTo(docProject, docPublication, entity);

														htmDef.WriteFooter(docPublication.Footer);
													}
												}
											}
										}

										// functions
										if (schema.Functions.Count > 0)
										{
											iSubSection++;

											htmTOC.WriteTOC(2, iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + " Functions");
											htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">" + iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + " Functions</td></tr>\r\n");
											int iEntity = 0;
											foreach (DocFunction entity in schema.Functions)
											{
												if (included == null || included.ContainsKey(entity))
												{
													iEntity++;

													string formatnum = iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + "." + iEntity.ToString();
													mapNumber.Add(entity, formatnum);

													htmTOC.WriteTOC(3, "<a class=\"listing-link\" href=\"schema/" + mapSchema[entity.Name].ToLower() + "/lexical/" + entity.Name.ToLower() + ".html\">" + formatnum + " " + entity.Name + "</a>");
													htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\"><a id=\"" + formatnum + "\">" + iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + "." + iEntity.ToString() + "</a> <a class=\"listing-link\" href=\"" + mapSchema[entity.Name].ToLower() + "/lexical/" + entity.Name.ToLower() + ".html\" target=\"info\">" + entity.Name + "</a></td></tr>\r\n");

													using (FormatHTM htmDef = new FormatHTM(pathSchema + @"\" + schema.Name.ToLower() + "\\lexical\\" + entity.Name.ToLower() + ".html", mapEntity, mapSchema, included))
													{
														htmDef.WriteHeader(entity.Name, iSection, iSchema, iSubSection, iEntity, docPublication.Header);
														htmDef.WriteScript(iSection, iSchema, iSubSection, iEntity);

														htmDef.WriteLine("<h4 class=\"num\">" + entity.Name + "</h4>");

														htmDef.WriteLocalizationSection(entity, locales, docPublication);

														htmDef.WriteLine("<section>");
														htmDef.WriteLine("<h5 class=\"num\">Semantic definitions at the function</h5>");

														htmDef.WriteSummaryHeader("Function Definition", true, docPublication);
														htmDef.WriteLine("<p>");
														htmDef.WriteDocumentationMarkup(entity.DocumentationHtml(), entity, docPublication, path);
														htmDef.WriteLine("</p>");
														htmDef.WriteSummaryFooter(docPublication);

														htmDef.WriteLine("</section>");

														htmDef.WriteLine("<section>");
														htmDef.WriteLine("<h5 class=\"num\">Formal representations</h5>");

														htmDef.WriteSummaryHeader("EXPRESS Specification", true, docPublication);
														htmDef.Write("<div class=\"xsd\"><code class=\"xsd\">");
														htmDef.WriteExpressFunction(entity);
														htmDef.Write("</code></div>");
														htmDef.WriteSummaryFooter(docPublication);

														htmDef.WriteLine("</section>");

														// write url for incoming page link
														htmDef.WriteLinkTo(docProject, docPublication, entity);

														htmDef.WriteFooter(docPublication.Footer);
													}
												}
											}
										}

										// rules
										if (schema.GlobalRules.Count > 0)
										{
											iSubSection++;

											htmTOC.WriteTOC(2, iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + " Rules");
											htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">" + iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + " Rules</td></tr>\r\n");
											int iEntity = 0;
											foreach (DocGlobalRule entity in schema.GlobalRules)
											{
												if (included == null || included.ContainsKey(entity))
												{
													iEntity++;

													string formatnum = iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + "." + iEntity.ToString();
													mapNumber.Add(entity, formatnum);

													htmTOC.WriteTOC(3, "<a class=\"listing-link\" href=\"schema/" + mapSchema[entity.Name].ToLower() + "/lexical/" + entity.Name.ToLower() + ".html\">" + formatnum + " " + entity.Name + "</a>");
													htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\"><a id=\"" + formatnum + "\">" + iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + "." + iEntity.ToString() + "</a> <a href=\"" + mapSchema[entity.Name].ToLower() + "/lexical/" + entity.Name.ToLower() + ".html\" target=\"info\">" + entity.Name + "</a></td></tr>\r\n");

													using (FormatHTM htmDef = new FormatHTM(pathSchema + @"\" + schema.Name.ToLower() + "\\lexical\\" + entity.Name.ToLower() + ".html", mapEntity, mapSchema, included))
													{
														htmDef.WriteHeader(entity.Name, iSection, iSchema, iSubSection, iEntity, docPublication.Header);
														htmDef.WriteScript(iSection, iSchema, iSubSection, iEntity);

														htmDef.WriteLine("<h4 class=\"num\">" + entity.Name + "</h4>");

														htmDef.WriteLocalizationSection(entity, locales, docPublication);

														htmDef.WriteLine("<section>");
														htmDef.WriteLine("<h5 class=\"num\">Semantic definitions at the global rule</h5>");

														htmDef.WriteSummaryHeader("Global Rule Definition", true, docPublication);
														htmDef.WriteLine("<p>");
														htmDef.WriteDocumentationMarkup(entity.DocumentationHtml(), entity, docPublication, path);
														htmDef.WriteLine("</p>");
														htmDef.WriteSummaryFooter(docPublication);

														htmDef.WriteLine("</section>");

														htmDef.WriteLine("<section>");
														htmDef.WriteLine("<h5 class=\"num\">Formal representations</h5>");

														htmDef.WriteSummaryHeader("EXPRESS Specification", true, docPublication);
														htmDef.WriteLine("<span class=\"express\">\r\n");
														htmDef.WriteExpressGlobalRule(entity);
														htmDef.WriteLine("</span>\r\n");
														htmDef.WriteSummaryFooter(docPublication);

														htmDef.WriteLine("</section>");

														// write url for incoming page link
														htmDef.WriteLinkTo(docProject, docPublication, entity);

														htmDef.WriteFooter(docPublication.Footer);
													}
												}
											}
										}

										// property sets
										if (schema.PropertySets.Count > 0)
										{
											iSubSection++;

											htmTOC.WriteTOC(2, iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + " Property Sets");
											htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">" + iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + " Property Sets</td></tr>\r\n");
											int iPset = 0;
											foreach (DocPropertySet entity in schema.PropertySets)
											{
												if (worker.CancellationPending)
													return null;

												if (entity.IsVisible())
												{
													if (included == null || included.ContainsKey(entity))
													{
														iPset++;

														string formatnum = iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + "." + iPset.ToString();
														mapNumber.Add(entity, formatnum);

														htmTOC.WriteTOC(3, "<a class=\"listing-link\" href=\"schema/" + mapSchema[entity.Name].ToLower() + "/pset/" + entity.Name.ToLower() + ".html\">" + formatnum + " " + entity.Name + "</a>");
														htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\"><a id=\"" + formatnum + "\">" + formatnum + "</a> <a class=\"listing-link\" href=\"" + mapSchema[entity.Name].ToLower() + "/pset/" + entity.Name.ToLower() + ".html\" target=\"info\">" + entity.Name + "</a></td></tr>\r\n");

														using (FormatHTM htmDef = new FormatHTM(pathSchema + @"\" + schema.Name.ToLower() + "\\pset\\" + entity.Name.ToLower() + ".html", mapEntity, mapSchema, included))
														{
															htmDef.WriteHeader(entity.Name, iSection, iSchema, iSubSection, iPset, docPublication.Header);
															htmDef.WriteScript(iSection, iSchema, iSubSection, iPset);
															htmDef.WriteLine("<h4 class=\"std\">" + iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + "." + iPset.ToString() + " " + entity.Name + "</h4>");

															if (!String.IsNullOrEmpty(entity.ApplicableType))
															{
																htmDef.Write("<p>");
																htmDef.WriteDefinition(entity.PropertySetType);
																htmDef.WriteLine("/");

																if (entity.ApplicableType != null && entity.ApplicableType.Contains("/"))
																{
																	// break out, e.g. "IfcSensor/TEMPERATURESENSOR"
																	string[] applicableparts = entity.ApplicableType.Split('/');
																	for (int iapppart = 0; iapppart < applicableparts.Length; iapppart++)
																	{
																		if (iapppart > 0)
																		{
																			htmDef.Write(" / ");
																		}
																		htmDef.WriteDefinition(applicableparts[iapppart]);
																	}
																}
																else
																{
																	htmDef.WriteDefinition(entity.ApplicableType);
																}
																htmDef.Write("</p>");
															}

															// english by default
															htmDef.WriteLocalizationSection(entity, locales, docPublication);
															htmDef.WriteChangeLog(entity, listChangeSets, docPublication);

															htmDef.WriteSummaryHeader("Properties", true, docPublication);
															if (!docPublication.ISO)//!Properties.Settings.Default.NoXml)
															{
																////htmDef.WriteLine("<p><a href=\"http://lookup.bsdd.buildingsmart.com/api/4.0/IfdPSet/search/" + entity.Name + "\" target=\"ifd\"><img src=\"../../../img/external.png\" title=\"Link to IFD\"/> buildingSMART Data Dictionary</a></p>\r\n");
																//http://lookup.bsdd.buildingsmart.com/api/4.0/IfdPSet/search/Pset_ActionRequest

																// use guid
																string guid = GlobalId.Format(entity.Uuid);
																htmDef.WriteLine("<p><a href=\"http://lookup.bsdd.buildingsmart.com/api/4.0/IfdPSet/" + guid + "/ifcVersion/2x4\" target=\"ifd\"><img border=\"0\" src=\"../../../img/external.png\" title=\"Link to IFD\"/> buildingSMART Data Dictionary</a></p>\r\n");

																htmDef.WriteLine("<p><a href=\"../../../psd/" + entity.Name + ".xml\"><img border=\"0\" src=\"../../../img/diagram.png\" title=\"Link to PSD-XML\"/> PSD-XML</a></p>\r\n");
															}

															DocEntity[] apptypes = entity.GetApplicableTypeDefinitions(docProject);
															DocEntity applicableentity = null;
															if (apptypes != null && apptypes.Length > 0 && apptypes[0] != null)
															{
																applicableentity = docProject.GetDefinition(apptypes[0].BaseDefinition) as DocEntity;
															}

															// write diagram if it exists
															htmDef.WriteLine(FormatFigure(docProject, entity, null, entity.Name, listFigures, path));
															htmDef.WriteProperties(entity.Properties, docProject, applicableentity, locales);
															htmDef.WriteSummaryFooter(docPublication);

															// write url for incoming page link
															htmDef.WriteLinkTo(docProject, docPublication, entity);

															htmDef.WriteFooter(docPublication.Footer);
														}

														// generate PSD listing
														using (FormatXML formatPSD = new FormatXML(path + @"\psd\" + entity.Name + ".xml", typeof(PropertySetDef)))//, PropertySetDef.DefaultNamespace)) // full casing for compatibility with original files
														{
															formatPSD.Instance = Program.ExportPsd(entity, mapPropEnum, docProject);
															formatPSD.Save();
														}
													}
												}
											}
										}


										// quantity sets (assume properties always exist for such schemas so always section 4)
										if (schema.QuantitySets.Count > 0)
										{
											iSubSection++;

											htmTOC.WriteTOC(2, iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + " Quantity Sets");
											htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">" + iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + " Quantity Sets</td></tr>\r\n");
											int iPset = 0;
											foreach (DocQuantitySet entity in schema.QuantitySets)
											{
												if (worker.CancellationPending)
													return null;

												if (included == null || included.ContainsKey(entity))
												{
													iPset++;

													string formatnum = iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + "." + iPset.ToString();
													mapNumber.Add(entity, formatnum);

													htmTOC.WriteTOC(3, "<a class=\"listing-link\" href=\"schema/" + mapSchema[entity.Name].ToLower() + "/qset/" + entity.Name.ToLower() + ".html\">" + formatnum + " " + entity.Name + "</a>");
													htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\"><a id=\"" + formatnum + "\">" + formatnum + "</a> <a class=\"listing-link\" href=\"" + mapSchema[entity.Name].ToLower() + "/qset/" + entity.Name.ToLower() + ".html\" target=\"info\">" + entity.Name + "</a></td></tr>\r\n");

													using (FormatHTM htmDef = new FormatHTM(pathSchema + @"\" + schema.Name.ToLower() + "\\qset\\" + entity.Name.ToLower() + ".html", mapEntity, mapSchema, included))
													{
														htmDef.WriteHeader(entity.Name, iSection, iSchema, iSubSection, iPset, docPublication.Header);
														htmDef.WriteScript(iSection, iSchema, iSubSection, iPset);
														htmDef.WriteLine("<h4 class=\"std\">" + iSection.ToString() + "." + iSchema.ToString() + "." + iSubSection.ToString() + "." + iPset.ToString() + " " + entity.Name + "</h4>");

														if (!String.IsNullOrEmpty(entity.ApplicableType))
														{
															htmDef.Write("<p>");

															htmDef.WriteDefinition("QTO_TYPEDRIVENOVERRIDE");
															htmDef.WriteLine("/");
															htmDef.WriteDefinition(entity.ApplicableType);
															htmDef.Write("</p>");
														}

														// english by default
														htmDef.WriteLocalizationSection(entity, locales, docPublication);
														htmDef.WriteChangeLog(entity, listChangeSets, docPublication);

														htmDef.WriteSummaryHeader("Quantities", true, docPublication);
														if (!docPublication.ISO)//!Properties.Settings.Default.NoXml)
														{
															htmDef.WriteLine("<p><a href=\"../../../qto/" + entity.Name + ".xml\"><img border=\"0\" src=\"../../../img/diagram.png\" title=\"Link to QTO-XML\"/> QTO-XML</a></p>\r\n");
														}

														// write each quantity
														htmDef.WriteLine("<table class=\"gridtable\">");
														htmDef.WriteLine("<tr><th>Name</th><th>Type</th><th>Description</th>");
														foreach (DocQuantity docprop in entity.Quantities)
														{
															htmDef.WriteLine("<tr><td>" + docprop.Name + "</td><td>");
															htmDef.WriteDefinition(docprop.QuantityType.ToString());
															htmDef.WriteLine("</td><td>");

															htmDef.WriteLocalizationTable(docprop, locales);

															htmDef.WriteLine("</td></tr>");
														}
														htmDef.WriteLine("</table>");
														htmDef.WriteSummaryFooter(docPublication);

														// write url for incoming page link
														htmDef.WriteLinkTo(docProject, docPublication, entity);

														htmDef.WriteFooter(docPublication.Footer);
													}

													// generate PSD listing
													using (FormatXML formatPSD = new FormatXML(path + @"\qto\" + entity.Name + ".xml", typeof(QtoSetDef), QtoSetDef.DefaultNamespace)) // full casing for compatibility with original files
													{
														formatPSD.Instance = Program.ExportQto(entity, docProject);
														formatPSD.Save();
													}

												}
											}
										}
									}

									// v1.8: write links to express-g                                
									htmSchema.WriteLine(
									"<p><a href=\"../../annex/annex-d/" + MakeLinkName(schema) + "/index.html\" ><img src=\"../../img/diagram.png\" style=\"border: 0px\" title=\"Link to EXPRESS-G diagram\" alt=\"Link to EXPRESS-G diagram\">&nbsp;EXPRESS-G diagram</a></p>");

									// link to this page
									htmSchema.WriteLinkTo(docProject, docPublication, schema);

									htmSchema.WriteFooter(docPublication.Footer);
								}
							}
						}

						htmSectionTOC.WriteLine(
							"</table>\r\n" +
							"</div>\r\n" +
							"</body>\r\n" +
							"</html>\r\n");
					}
				}

				int iAnnex = 0;
				char chAnnex = 'A';
				foreach (DocAnnex docannex in docProject.Annexes)
				{
					worker.ReportProgress(++progressCurrent, docannex);

					iAnnex--;
					htmTOC.WriteTOC(0, "<a class=\"listing-link\" href=\"annex/annex-" + chAnnex.ToString().ToLower() + ".html\">Annex " + chAnnex.ToString() + ". " + docannex.Name + "</a>");

					// write the section page
					using (FormatHTM htmSection = new FormatHTM(path + @"\annex\annex-" + chAnnex.ToString().ToLower() + @".html", mapEntity, mapSchema, included))
					{
						htmSection.WriteHeader(docannex.Name, iAnnex, 0, 0, 0, docPublication.Header);
						htmSection.WriteScript(iAnnex, 0, 0, 0);
						htmSection.WriteLine("<h1 class=\"annex\">Annex " + chAnnex.ToString() + "</h1>");
						if (chAnnex == 'A')
						{
							htmSection.WriteLine("<div align=\"center\">(normative)</div>");
						}
						else
						{
							htmSection.WriteLine("<div align=\"center\">(informative)</div>");
						}
						htmSection.WriteLine("<h1 class=\"annex\">" + docannex.Name + "</h1>");

						if (chAnnex == 'A')// && String.IsNullOrEmpty(docannex.Documentation))
						{
							string uriprefix = docProject.GetSchemaURI(docPublication);
							string version = docProject.GetSchemaIdentifier();
							string release = docPublication.GetReleaseIdentifier();

							// now automatic -- specific text required by ISO
							htmSection.WriteLine(
								"<p>This annex contains a listing of the complete schema combining all definitions " +
								"of clauses 5, 6, 7, and 8 without comments or other explanatory text. " +
								"These listings are available in computer-interpretable form that may be parsed by computer.</p>");

							if (!docPublication.ISO)
							{
								htmSection.WriteLine("<p>Official schema publications for this release are at the following URLs:</p>");

								htmSection.WriteLine("<table class=\"gridtable\">");
								htmSection.WriteLine("<tr><th>Format</th><th>URL official</th></tr>");
								foreach (DocFormat docFormat in docPublication.Formats)
								{
									if (docFormat.FormatOptions != DocFormatOptionEnum.None)
									{
										string formatdesc = docFormat.FormatType.ToString();
										System.Reflection.FieldInfo fieldinfo = typeof(DocFormatSchemaEnum).GetField(docFormat.FormatType.ToString(), System.Reflection.BindingFlags.Static | System.Reflection.BindingFlags.Public);
										DescriptionAttribute[] attrs = (DescriptionAttribute[])fieldinfo.GetCustomAttributes(typeof(DescriptionAttribute), false);
										if (attrs.Length == 1)
										{
											formatdesc = attrs[0].Description;
										}
									
										//string formaturi = uriprefix + "/" + version + "_" + release.ToUpper() + "." + docFormat.ExtensionSchema;
										string formatUri = uriprefix + "/" + "IFC4" /*version*/ + "." + docFormat.ExtensionSchema;
										string formatName = formatUri;
										if (!checkWebsite(formatUri))
										{ 
											var view = docPublication.Views.Where(x => x.Code == docPublication.Code).FirstOrDefault();
											// annex-a/construction-objects-data-view/COD.1.xsd
											formatName = $"{docPublication.Code}.{docFormat.ExtensionSchema}";
											formatUri = $"annex-a/{view.Name.Replace(" ","-").ToLower()}/{formatName}";
										}

										htmSection.WriteLine("<tr><td>" + formatdesc + "</td><td><a href=\"" + formatUri + "\" target=\"_blank\">" + formatName + "</a></td></tr>");
									}
								}
								htmSection.WriteLine("</table>");
							}

							htmSection.WriteLine("</ul>");
						}
						else
						{
							// no numbering for annex currently... docannex.Documentation = UpdateNumbering(section.Documentation, ref iFigure, ref iTable);
							htmSection.WriteDocumentationMarkup(docannex.DocumentationHtml(), docannex, docPublication, path);
						}

						if (chAnnex == 'C')
						{
							htmSection.WriteInheritanceMapping(docProject, views, docPublication);
						}

						htmSection.WriteLinkTo(docPublication, "annex-" + chAnnex.ToString().ToLower(), 1);
						htmSection.WriteFooter(docPublication.Footer);
					}

					using (FormatHTM htmSectionTOC = new FormatHTM(path + @"\annex\toc-" + chAnnex.ToString().ToLower() + ".html", mapEntity, mapSchema, included))
					{
						htmSectionTOC.WriteLine(
							"<html> \r\n" +
							"<head> \r\n" +
							"<meta http-equiv=\"Content-Type\" content=\"text/html; charset=UTF-8\"> \r\n" +
							"<link rel=\"stylesheet\" type=\"text/css\" href=\"../ifc-styles.css\"> \r\n" +
							"<title>Section Contents</title> \r\n" +
							"</head> \r\n" +
							"<body class=\"image\"> \r\n" +
							"<div class=\"menu\">\r\n" +
							"<table class=\"menu\" summary=\"Table of Contents\">\r\n");

						// top level
						htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">" + chAnnex + ". <a class=\"listing-link\" href=\"annex-" + chAnnex.ToString().ToLower() + ".html\" target=\"info\" >" + docannex.Name + "</a></td></tr>\r\n");

						switch (chAnnex)
						{
							case 'A':
								// each MVD has specific schema
								if (true) // todo: refactor and re-enable in future to support hierarchy of MVDs that have official publications...
								{
									int[] indexpath = new int[1];
									foreach (DocModelView docModelView in docProject.ModelViews)
									{
										if ((included == null || included.ContainsKey(docModelView)))
										{
											htmSectionTOC.WriteLine("<tr><td>&nbsp;</td></tr>");

											indexpath[0]++;
											GenerateListings(docProject, docPublication, docModelView,
												mapEntity, mapSchema, included, locales, mapFormatSchema,
												indexpath, pathPublication,
												htmTOC, htmSectionTOC);
										}
									}
								}
								break;

							case 'B':
								// alphabetical listings
								htmTOC.WriteTOC(1, "B.1 Definitions");
								htmSectionTOC.WriteLine("<tr><td>&nbsp;</td></tr>");
								htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">B.1 Definitions</td></tr>");

								htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"annex/annex-b/alphabeticalorder_definedtypes.html\" >B.1.1 Defined types</a>");
								htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">B.1.1 <a href=\"annex-b/alphabeticalorder_definedtypes.html\" target=\"info\" >Defined types</a></td></tr>");
								htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"annex/annex-b/alphabeticalorder_enumtypes.html\" >B.1.2 Enumeration types</a>");
								htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">B.1.2 <a href=\"annex-b/alphabeticalorder_enumtypes.html\" target=\"info\" >Enumeration types</a></td></tr>");
								htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"annex/annex-b/alphabeticalorder_selecttypes.html\" >B.1.3 Select types</a>");
								htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">B.1.3 <a href=\"annex-b/alphabeticalorder_selecttypes.html\" target=\"info\" >Select types</a></td></tr>");
								htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"annex/annex-b/alphabeticalorder_entities.html\" >B.1.4 Entities</a>");
								htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">B.1.4 <a href=\"annex-b/alphabeticalorder_entities.html\" target=\"info\" >Entities</a></td></tr>");
								htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"annex/annex-b/alphabeticalorder_functions.html\" >B.1.5 Functions</a>");
								htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">B.1.5 <a href=\"annex-b/alphabeticalorder_functions.html\" target=\"info\" >Functions</a></td></tr>");
								htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"annex/annex-b/alphabeticalorder_rules.html\" >B.1.6 Rules</a>");
								htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">B.1.6 <a href=\"annex-b/alphabeticalorder_rules.html\" target=\"info\" >Rules</a></td></tr>");
								htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"annex/annex-b/alphabeticalorder_psets.html\" >B.1.7 Property sets</a>");
								htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">B.1.7 <a href=\"annex-b/alphabeticalorder_psets.html\" target=\"info\" >Property sets</a></td></tr>");
								htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"annex/annex-b/alphabeticalorder_qsets.html\" >B.1.8 Quantity sets</a>");
								htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">B.1.8 <a href=\"annex-b/alphabeticalorder_qsets.html\" target=\"info\" >Quantity sets</a></td></tr>");

								htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"annex/annex-b/alphabeticalorder_psets.html\" >B.1.9 Individual properties</a>");
								htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">B.1.9 <a href=\"annex-b/alphabeticalorder_properties.html\" target=\"info\" >Individual properties</a></td></tr>");
								htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"annex/annex-b/alphabeticalorder_penums.html\" >B.1.10 Property Enumerations</a>");
								htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">B.1.10 <a href=\"annex-b/alphabeticalorder_propertyenums.html\" target=\"info\" >Property Enumerations</a></td></tr>");

								// generate alphabetical listings
								using (FormatHTM htmAlpha1 = new FormatHTM(path + "/annex/annex-b/alphabeticalorder_definedtypes.html", mapEntity, mapSchema, included))
								{
									htmAlpha1.WriteAlphabeticalListing<DocDefined>("Defined Types", path, "definedtypes", docPublication);
								}
								using (FormatHTM htmAlpha1 = new FormatHTM(path + "/annex/annex-b/alphabeticalorder_enumtypes.html", mapEntity, mapSchema, included))
								{
									htmAlpha1.WriteAlphabeticalListing<DocEnumeration>("Enumeration Types", path, "enumtypes", docPublication);
								}
								using (FormatHTM htmAlpha1 = new FormatHTM(path + "/annex/annex-b/alphabeticalorder_selecttypes.html", mapEntity, mapSchema, included))
								{
									htmAlpha1.WriteAlphabeticalListing<DocSelect>("Select Types", path, "selecttypes", docPublication);
								}
								using (FormatHTM htmAlpha1 = new FormatHTM(path + "/annex/annex-b/alphabeticalorder_entities.html", mapEntity, mapSchema, included))
								{
									htmAlpha1.WriteAlphabeticalListing<DocEntity>("Entities", path, "entities", docPublication);
								}
								using (FormatHTM htmAlpha1 = new FormatHTM(path + "/annex/annex-b/alphabeticalorder_functions.html", mapEntity, mapSchema, included))
								{
									htmAlpha1.WriteAlphabeticalListing<DocFunction>("Functions", path, "functions", docPublication);
								}
								using (FormatHTM htmAlpha1 = new FormatHTM(path + "/annex/annex-b/alphabeticalorder_rules.html", mapEntity, mapSchema, included))
								{
									htmAlpha1.WriteAlphabeticalListing<DocGlobalRule>("Rules", path, "rules", docPublication);
								}
								// no translations currently -- enable in future
								using (FormatHTM htmAlpha1 = new FormatHTM(path + "/annex/annex-b/alphabeticalorder_psets.html", mapEntity, mapSchema, included))
								{
									htmAlpha1.WriteAlphabeticalListing<DocPropertySet>("Property Sets", path, "psets", docPublication);
								}
								using (FormatHTM htmAlpha1 = new FormatHTM(path + "/annex/annex-b/alphabeticalorder_propertyenums.html", mapEntity, mapSchema, included))
								{
									htmAlpha1.WriteAlphabeticalListing<DocPropertyEnumeration>("Property Enumerations", path, "propertyenums", docPublication);
								}
								using (FormatHTM htmAlpha1 = new FormatHTM(path + "/annex/annex-b/alphabeticalorder_qsets.html", mapEntity, mapSchema, included))
								{
									htmAlpha1.WriteAlphabeticalListing<DocQuantitySet>("Quantity Sets", path, "qsets", docPublication);
								}


								// locales
								int indexb = 1;
								if (locales != null)
								{
									foreach (string locale in locales)
									{
										indexb++;

										string localeheader = locale.ToUpper();
										if (locale == "zh")
										{
											localeheader += " [Chinese]"; // no language-generic info available
										}
										else
										{
											try
											{
												System.Globalization.CultureInfo cultureinfo = System.Globalization.CultureInfo.GetCultureInfo(locale);
												if (cultureinfo != null)
												{
													localeheader += " [" + cultureinfo.EnglishName + "]";
												}
											}
											catch
											{
											}
										}

										// each locale
										htmSectionTOC.WriteLine("<tr><td>&nbsp;</td></tr>");

										htmTOC.WriteTOC(1, "B." + indexb.ToString() + " " + localeheader);
										htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">B." + indexb.ToString() + " " + localeheader + "</td></tr>");

										htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"annex/annex-b/" + locale.ToLower() + "/alphabeticalorder_definedtypes.html\" >B." + indexb.ToString() + ".1 Defined types</a>");
										htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">B." + indexb.ToString() + ".1 <a href=\"annex-b/" + locale.ToLower() + "/alphabeticalorder_definedtypes.html\" target=\"info\" >Defined types</a></td></tr>");
										htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"annex/annex-b/" + locale.ToLower() + "/alphabeticalorder_enumtypes.html\" >B." + indexb.ToString() + ".2 Enumeration types</a>");
										htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">B." + indexb.ToString() + ".2 <a href=\"annex-b/" + locale.ToLower() + "/alphabeticalorder_enumtypes.html\" target=\"info\" >Enumeration types</a></td></tr>");
										htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"annex/annex-b/" + locale.ToLower() + "/alphabeticalorder_selecttypes.html\" >B." + indexb.ToString() + ".3 Select types</a>");
										htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">B." + indexb.ToString() + ".3 <a href=\"annex-b/" + locale.ToLower() + "/alphabeticalorder_selecttypes.html\" target=\"info\" >Select types</a></td></tr>");
										htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"annex/annex-b/" + locale.ToLower() + "/alphabeticalorder_entities.html\" >B." + indexb.ToString() + ".4 Entities</a>");
										htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">B." + indexb.ToString() + ".4 <a href=\"annex-b/" + locale.ToLower() + "/alphabeticalorder_entities.html\" target=\"info\" >Entities</a></td></tr>");
										htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"annex/annex-b/" + locale.ToLower() + "/alphabeticalorder_functions.html\" >B." + indexb.ToString() + ".5 Functions</a>");
										htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">B." + indexb.ToString() + ".5 <a href=\"annex-b/" + locale.ToLower() + "/alphabeticalorder_functions.html\" target=\"info\" >Functions</a></td></tr>");
										htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"annex/annex-b/" + locale.ToLower() + "/alphabeticalorder_rules.html\" >B." + indexb.ToString() + ".6 Rules</a>");
										htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">B." + indexb.ToString() + ".6 <a href=\"annex-b/" + locale.ToLower() + "/alphabeticalorder_rules.html\" target=\"info\" >Rules</a></td></tr>");

										/* no translations currently -- enable in future
                                        htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"annex/annex-b/" + locale.ToLower() + "/alphabeticalorder_psets.html\" >B." + indexb.ToString() + ".7 Property sets</a>");
                                        htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\"><a href=\"annex-b/" + locale.ToLower() + "/alphabeticalorder_psets.html\" target=\"info\" >B." + indexb.ToString() + ".7 Property sets</a></td></tr>");
                                        htmTOC.WriteTOC(2, "<a class=\"listing-link\" href=\"annex/annex-b/" + locale.ToLower() + "/alphabeticalorder_qsets.html\" >B." + indexb.ToString() + ".8 Quantity sets</a>");
                                        htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\"><a href=\"annex-b/" + locale.ToLower() + "/alphabeticalorder_qsets.html\" target=\"info\" >B." + indexb.ToString() + ".8 Quantity sets</a></td></tr>");
                                         */
									}


									// generate localized listings
									foreach (string locale in listLocale.Keys)
									{
										string code = listLocale[locale]; // null for default

										using (FormatHTM htmAlpha1 = new FormatHTM(path + "/annex/annex-b/" + locale + "/alphabeticalorder_definedtypes.html", mapEntity, mapSchema, included))
										{
											htmAlpha1.WriteLocalizedListing<DocDefined>("Defined Types", code, path, "definedtypes", docPublication);
										}
										using (FormatHTM htmAlpha1 = new FormatHTM(path + "/annex/annex-b/" + locale + "/alphabeticalorder_enumtypes.html", mapEntity, mapSchema, included))
										{
											htmAlpha1.WriteLocalizedListing<DocEnumeration>("Enumeration Types", code, path, "enumtypes", docPublication);
										}
										using (FormatHTM htmAlpha1 = new FormatHTM(path + "/annex/annex-b/" + locale + "/alphabeticalorder_selecttypes.html", mapEntity, mapSchema, included))
										{
											htmAlpha1.WriteLocalizedListing<DocSelect>("Select Types", code, path, "selecttypes", docPublication);
										}
										using (FormatHTM htmAlpha1 = new FormatHTM(path + "/annex/annex-b/" + locale + "/alphabeticalorder_entities.html", mapEntity, mapSchema, included))
										{
											htmAlpha1.WriteLocalizedListing<DocEntity>("Entities", code, path, "entities", docPublication);
										}
										using (FormatHTM htmAlpha1 = new FormatHTM(path + "/annex/annex-b/" + locale + "/alphabeticalorder_functions.html", mapEntity, mapSchema, included))
										{
											htmAlpha1.WriteLocalizedListing<DocFunction>("Functions", code, path, "functions", docPublication);
										}
										using (FormatHTM htmAlpha1 = new FormatHTM(path + "/annex/annex-b/" + locale + "/alphabeticalorder_rules.html", mapEntity, mapSchema, included))
										{
											htmAlpha1.WriteLocalizedListing<DocGlobalRule>("Rules", code, path, "rules", docPublication);
										}
										using (FormatHTM htmAlpha1 = new FormatHTM(path + "/annex/annex-b/" + locale + "/alphabeticalorder_psets.html", mapEntity, mapSchema, included))
										{
											htmAlpha1.WriteLocalizedListing<DocPropertySet>("Property Sets", code, path, "psets", docPublication);
										}
										using (FormatHTM htmAlpha1 = new FormatHTM(path + "/annex/annex-b/" + locale + "/alphabeticalorder_qsets.html", mapEntity, mapSchema, included))
										{
											htmAlpha1.WriteLocalizedListing<DocQuantitySet>("Quantity Sets", code, path, "qsets", docPublication);
										}

									}
								}
								break;

							case 'C':
								// Inheritance listings

								if (docProject.ModelViews != null)
								{
									//... recursive nesting...

									int iView = 0;
									foreach (DocModelView docView in docProject.ModelViews)
									{
										if (included == null || included.ContainsKey(docView))
										{
											iView++;

											htmSectionTOC.WriteLine("<tr><td>&nbsp;</td></tr>");

											htmTOC.WriteTOC(1, "<a class=\"listing-link\" href=\"annex/annex-c/" + MakeLinkName(docView) + "/index.html\" >C." + iView + " " + docView.Name + "</a>");
											htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">C." + iView + " <a href=\"annex-c/" + MakeLinkName(docView) + "/index.html\" target=\"info\" >" + docView.Name + "</a></td></tr>");

											// diagram for view
											//if (!Properties.Settings.Default.SkipDiagrams)
											{
												Dictionary<DocObject, bool> viewinclude = new Dictionary<DocObject, bool>();
												Dictionary<Rectangle, DocEntity> mapRectangle = new Dictionary<Rectangle, DocEntity>();
												docProject.RegisterObjectsInScope(docView, viewinclude);
												using (Image imgDiagram = FormatPNG.CreateInheritanceDiagram(docProject, viewinclude, docEntityRoot, null, new Font(FontFamily.GenericSansSerif, 8.0f), mapRectangle))
												{
													using (FormatHTM htmCover = new FormatHTM(path + @"\annex\annex-c\" + MakeLinkName(docView) + @"\index.html", mapEntity, mapSchema, included))
													{
														htmCover.WriteHeader(docView.Name, 3, docPublication.Header);
														htmCover.WriteLine("<h2 class=\"std\">C." + iView + " " + docView.Name + " Inheritance</h2>");
														htmCover.WriteLine("<img src=\"cover.png\" usemap=\"#f\"/>");
														htmCover.WriteLine("<map name=\"f\">");

														foreach (Rectangle rc in mapRectangle.Keys)
														{
															DocEntity docEntref = mapRectangle[rc];
															DocSchema docEntsch = docProject.GetSchemaOfDefinition(docEntref);

															string hyperlink = "../../../schema/" + docEntsch.Name.ToLower() + "/lexical/" + docEntref.Name.ToLower() + ".html";
															htmCover.WriteLine("<area shape=\"rect\" coords=\"" + rc.Left + "," + rc.Top + "," + rc.Right + "," + rc.Bottom + "\" href=\"" + hyperlink + "\" alt=\"" + docEntref.Name + "\" />");
														}
														htmCover.WriteLine("</map>");
														htmCover.WriteLinkTo(docPublication, "inheritance-" + MakeLinkName(docView), 3);
														htmCover.WriteFooter(String.Empty);

														using (FormatHTM htmLink = new FormatHTM(path + "/link/inheritance-" + MakeLinkName(docView) + ".html", mapEntity, mapSchema, included))
														{
															htmLink.WriteLinkPage("../annex/annex-c/" + DocumentationISO.MakeLinkName(docView) + "/index.html", docPublication);
														}
													}

													// create image after (depends on directory being created first)
													try
													{
														imgDiagram.Save(path + @"\annex\annex-c\" + MakeLinkName(docView) + @"\cover.png");
													}
													catch
													{

													}
												}
											}



											// all entities
											htmTOC.WriteTOC(1, "<a class=\"listing-link\" href=\"annex/annex-c/" + MakeLinkName(docView) + "/all.html\" >C." + iView + ".1 All entities</a>");
											htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">C." + iView + ".1 <a href=\"annex-c/" + MakeLinkName(docView) + "/all.html\" target=\"info\" >All entities</a></td></tr>");
											using (FormatHTM htmInheritAll = new FormatHTM(path + "/annex/annex-c/" + MakeLinkName(docView) + "/all.html", mapEntity, mapSchema, included))
											{
												htmInheritAll.WriteInheritanceListing(null, false, "All entities", docView, path, "all", docPublication);
											}

											// specific inheritance
											htmTOC.WriteTOC(1, "<a class=\"listing-link\" href=\"annex/annex-c/" + MakeLinkName(docView) + "/roots.html\" >C." + iView + ".2 Rooted entities</a>");
											htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">C." + iView + ".2 <a href=\"annex-c/" + MakeLinkName(docView) + "/roots.html\" target=\"info\" >Rooted entities</a></td></tr>");
											using (FormatHTM htmInheritAll = new FormatHTM(path + "/annex/annex-c/" + MakeLinkName(docView) + "/roots.html", mapEntity, mapSchema, included))
											{
												htmInheritAll.WriteInheritanceListing("IfcRoot", false, "Rooted entities", docView, path, "roots", docPublication);
											}

											htmTOC.WriteTOC(1, "<a class=\"listing-link\" href=\"annex/annex-c/" + MakeLinkName(docView) + "/types.html\" >C." + iView + ".3 Object types</a>");
											htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">C." + iView + ".3 <a href=\"annex-c/" + MakeLinkName(docView) + "/types.html\" target=\"info\" >Object types</a></td></tr>");
											using (FormatHTM htmInheritAll = new FormatHTM(path + "/annex/annex-c/" + MakeLinkName(docView) + "/types.html", mapEntity, mapSchema, included))
											{
												htmInheritAll.WriteInheritanceListing("IfcObject", true, "Object types", docView, path, "types", docPublication);
											}

											htmSectionTOC.WriteLine("<tr><td>&nbsp;</td></tr>");

										}
									}
								}
								break;

							case 'D':
								// Diagrams

								// Express-G diagrams
								htmTOC.WriteTOC(1, "D.1 Schema diagrams");
								htmSectionTOC.WriteLine("<tr><td>&nbsp;</td></tr>");
								htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">D.1 Schema diagrams</td></tr>");

								for (int iSchemaSection = 5; iSchemaSection <= 8; iSchemaSection++)
								{
									DocSection docSection = docProject.Sections[iSchemaSection - 1];

									int iDiagramSection = iSchemaSection - 4;

									htmTOC.WriteTOC(2, "D.1." + iDiagramSection + " " + docSection.Name);
									htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">D.1." + iDiagramSection + " " + docSection.Name + "</td></tr>");


									int iSchema = 0;
									for (int iSchemaIndex = 1; iSchemaIndex <= docSection.Schemas.Count; iSchemaIndex++)
									{
										DocSchema docSchema = docSection.Schemas[iSchemaIndex - 1];
										if (included == null || included.ContainsKey(docSchema))
										{
											iSchema++;

											htmTOC.WriteTOC(3, "<a class=\"listing-link\" href=\"annex/annex-d/" + MakeLinkName(docSchema) + "/index.html\" >D.1." + iDiagramSection + "." + iSchema + " " + docSchema.Name + "</a>");
											htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">D.1." + iDiagramSection + "." + iSchema + " <a href=\"annex-d/" + MakeLinkName(docSchema) + "/index.html\" target=\"info\" >" + docSchema.Name + "</a></td></tr>");

											// determine number of diagrams
											int iLastDiagram = docSchema.UpdateDiagramPageNumbers();

											// generate diagrams
											//if (!Properties.Settings.Default.SkipDiagrams)
											{
												Image imageSchema = FormatPNG.CreateSchemaDiagram(docSchema, docProject, diagramformat);

												using (FormatHTM htmSchemaDiagram = new FormatHTM(path + "/annex/annex-d/" + MakeLinkName(docSchema) + "/index.html", mapEntity, mapSchema, included))
												{
													int iSub = 1;

													htmSchemaDiagram.WriteHeader(docSection.Name, 3, docPublication.Header);
													htmSchemaDiagram.WriteScript(iAnnex, iSub, iSection, 0);
													htmSchemaDiagram.WriteLine("<h4 class=\"std\">D.1." + iDiagramSection + "." + iSchema + " " + docSchema.Name + "</h4>");

													htmSchemaDiagram.WriteLine("<p>");

													// write thumbnail links for each diagram
													for (int iDiagram = 1; iDiagram <= iLastDiagram; iDiagram++)
													{
														string formatnumber = iDiagram.ToString("D4"); // 0001
														htmSchemaDiagram.WriteLine("<a href=\"diagram_" + formatnumber + ".html\">" +
															"<img src=\"diagram_" + formatnumber + ".png\" width=\"300\" height=\"444\" /></a>"); // width=\"150\" height=\"222\"> 

														// generate EXPRESS-G diagram
														if (docSchema.DiagramPagesHorz != 0)
														{
															int pageY = (iDiagram - 1) / docSchema.DiagramPagesHorz;
															int pageX = (iDiagram - 1) % docSchema.DiagramPagesHorz;
															int pagePixelCX = CtlExpressG.PageX;
															int pagePixelCY = CtlExpressG.PageY;
															using (Image imagePage = new Bitmap(pagePixelCX, pagePixelCY))
															{
																using (Graphics g = Graphics.FromImage(imagePage))
																{
																	g.DrawImage(imageSchema, new Rectangle(0, 0, pagePixelCX, pagePixelCY), new Rectangle(pagePixelCX * pageX, pagePixelCY * pageY, pagePixelCX, pagePixelCY), GraphicsUnit.Pixel);
																}
																imagePage.Save(path + "/annex/annex-d/" + MakeLinkName(docSchema) + "/diagram_" + formatnumber + ".png");
															}
														}
													}

													htmSchemaDiagram.WriteLine("</p>");
													htmSchemaDiagram.WriteFooter(docPublication.Footer);
												}


												double scale = 0.375; // hard-coded for now -- read from SCHEMATA.scale
												double pageCX = 1600; // hard-coded for now -- read from SCHEMATA.settings.page.width
												double pageCY = 2370; // hard-coded for now -- read from SCHEMATA.settings.page.height

												for (int iDiagram = 1; iDiagram <= iLastDiagram; iDiagram++)
												{
													string formatnumber = iDiagram.ToString("D4");
													using (FormatHTM htmSchema = new FormatHTM(path + "/annex/annex-d/" + MakeLinkName(docSchema) + "/diagram_" + formatnumber + ".html", mapEntity, mapSchema, included))
													{
														htmSchema.WriteHeader(docSchema.Name, 3, docPublication.Header);
														htmSchema.WriteScript(iAnnex, 1, iDiagramSection, iDiagram);

														htmSchema.WriteLine("<h4 class=\"std\">");
														if (iDiagram > 1)
														{
															htmSchema.Write("<a href=\"diagram_" + (iDiagram - 1).ToString("D4") + ".html\"><img src=\"../../../img/navleft.png\" style=\"border: 0px\" /></a>");
														}
														else
														{
															// disabled
															htmSchema.Write("<img src=\"../../../img/navleft.png\" style=\"border: 0px\" />");
														}
														if (iDiagram < iLastDiagram)
														{
															htmSchema.Write("<a href=\"diagram_" + (iDiagram + 1).ToString("D4") + ".html\"><img src=\"../../../img/navright.png\" style=\"border: 0px\" /></a>");
														}
														else
														{
															// disabled
															htmSchema.Write("<img src=\"../../../img/navright.png\" style=\"border: 0px\" />");
														}
														htmSchema.Write(" " + docSchema.Name + " (" + iDiagram + "/" + iLastDiagram + ")");
														htmSchema.WriteLine("</h4>");

														htmSchema.WriteLine("<img src=\"diagram_" + formatnumber + ".png\" usemap=\"#diagram\" >");
														htmSchema.WriteLine("  <map name=\"diagram\" >");
														foreach (DocType docType in docSchema.Types)
														{
															if ((included == null || included.ContainsKey(docType)) && docType.DiagramNumber == iDiagram && docType.DiagramRectangle != null)
															{
																double x0 = docType.DiagramRectangle.X % pageCX * scale;
																double y0 = docType.DiagramRectangle.Y % pageCY * scale;
																double x1 = docType.DiagramRectangle.X % pageCX * scale + docType.DiagramRectangle.Width % pageCX * scale;
																double y1 = docType.DiagramRectangle.Y % pageCY * scale + docType.DiagramRectangle.Height % pageCY * scale;
																string link = "../../../schema/" + mapSchema[docType.Name].ToLower() + "/lexical/" + docType.Name.ToLower() + ".html";
																htmSchema.WriteLine("    <area shape=\"rect\" coords=\"" + x0 + ", " + y0 + ", " + x1 + ", " + y1 + "\" alt=\"Navigate\" href=\"" + link + "\" />");
															}
														}
														foreach (DocEntity docType in docSchema.Entities)
														{
															if ((included == null || included.ContainsKey(docType)) && docType.DiagramNumber == iDiagram && docType.DiagramRectangle != null)
															{
																double x0 = docType.DiagramRectangle.X % pageCX * scale;
																double y0 = docType.DiagramRectangle.Y % pageCY * scale;
																double x1 = docType.DiagramRectangle.X % pageCX * scale + docType.DiagramRectangle.Width % pageCX * scale;
																double y1 = docType.DiagramRectangle.Y % pageCY * scale + docType.DiagramRectangle.Height % pageCY * scale;
																string link = "../../../schema/" + mapSchema[docType.Name].ToLower() + "/lexical/" + docType.Name.ToLower() + ".html";
																htmSchema.WriteLine("    <area shape=\"rect\" coords=\"" + x0 + ", " + y0 + ", " + x1 + ", " + y1 + "\" alt=\"Navigate\" href=\"" + link + "\" />");
															}
														}
														if (docSchema.PageTargets != null)
														{
															foreach (DocPageTarget docPageTarget in docSchema.PageTargets)
															{
																foreach (DocPageSource docPageSource in docPageTarget.Sources)
																{
																	if (docPageSource.DiagramNumber == iDiagram && docPageSource.DiagramRectangle != null)
																	{
																		double x0 = docPageSource.DiagramRectangle.X % pageCX * scale;
																		double y0 = docPageSource.DiagramRectangle.Y % pageCY * scale;
																		double x1 = docPageSource.DiagramRectangle.X % pageCX * scale + docPageSource.DiagramRectangle.Width % pageCX * scale;
																		double y1 = docPageSource.DiagramRectangle.Y % pageCY * scale + docPageSource.DiagramRectangle.Height % pageCY * scale;
																		string link = "diagram_" + docPageTarget.DiagramNumber.ToString("D4") + ".html";
																		htmSchema.WriteLine("    <area shape=\"rect\" coords=\"" + x0 + ", " + y0 + ", " + x1 + ", " + y1 + "\" alt=\"Navigate\" href=\"" + link + "\" />");
																	}
																}
															}
														}
														if (docSchema.SchemaRefs != null)
														{
															foreach (DocSchemaRef docSchemaRef in docSchema.SchemaRefs)
															{
																foreach (DocDefinitionRef docDefinitionRef in docSchemaRef.Definitions)
																{
																	if (docDefinitionRef.DiagramNumber == iDiagram && docDefinitionRef.DiagramRectangle != null)
																	{
																		double x0 = docDefinitionRef.DiagramRectangle.X % pageCX * scale;
																		double y0 = docDefinitionRef.DiagramRectangle.Y % pageCY * scale;
																		double x1 = docDefinitionRef.DiagramRectangle.X % pageCX * scale + docDefinitionRef.DiagramRectangle.Width % pageCX * scale;
																		double y1 = docDefinitionRef.DiagramRectangle.Y % pageCY * scale + docDefinitionRef.DiagramRectangle.Height % pageCY * scale;

																		if (mapSchema.ContainsKey(docDefinitionRef.Name))
																		{
																			DocDefinition docDef = mapEntity[docDefinitionRef.Name] as DocDefinition;
																			if (included == null || included.ContainsKey(docDef))
																			{
																				string link = "../../../schema/" + mapSchema[docDefinitionRef.Name].ToLower() + "/lexical/" + docDefinitionRef.Name.ToLower() + ".html";
																				htmSchema.WriteLine("    <area shape=\"rect\" coords=\"" + x0 + ", " + y0 + ", " + x1 + ", " + y1 + "\" alt=\"Navigate\" href=\"" + link + "\" />");
																			}
																		}
																	}
																}
															}
														}
														htmSchema.WriteLine("  </map>");
														htmSchema.WriteLine("</img>");
														htmSchema.WriteFooter(docPublication.Footer);
													}
												}
											}
										}
									}
								}

								// Instance diagrams
								htmTOC.WriteTOC(1, "D.2 Instance diagrams");
								htmSectionTOC.WriteLine("<tr><td>&nbsp;</td></tr>");
								htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">D.2 Instance diagrams</td></tr>");

								// D.1 -- schema diagrams - express-G
								// D.1.1 -- core layer
								// D.1.2 -- shared layer
								// D.1.3 -- domain layer
								// D.1.4 -- resource layer
								// D.1.4.1~ schema

								// D.2 -- instance diagrams
								// D.2.1~  model view
								// D.2.1.1~  entity

								if (docProject.ModelViews != null)
								{
									int iView = 0;
									foreach (DocModelView docView in docProject.ModelViews)
									{
										if (included == null || included.ContainsKey(docView))
										{
											iView++;

											htmTOC.WriteTOC(2, "D.2." + iView.ToString() + " " + docView.Name);
											htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">D.2." + iView.ToString() + "<a href=\"annex-d/" + MakeLinkName(docView) + "/cover.html\" target=\"info\"> " + docView.Name + "</a></td></tr>");


											Dictionary<DocObject, bool> viewinclude = new Dictionary<DocObject, bool>();
											Dictionary<Rectangle, DocEntity> mapRectangle = new Dictionary<Rectangle, DocEntity>();
											docProject.RegisterObjectsInScope(docView, viewinclude);
											using (FormatHTM htmCover = new FormatHTM(path + @"\annex\annex-d\" + MakeLinkName(docView) + @"\cover.html", mapEntity, mapSchema, included))
											{
												htmCover.WriteHeader(docView.Name, 3, docPublication.Header);
												htmCover.WriteLine("<h3 class=\"std\">D.2." + iView + " " + docView.Name + " Diagrams</h3>");
												htmCover.WriteFooter(String.Empty);
											}

											// sort by entity name
											SortedList<string, DocConceptRoot> listEntity = new SortedList<string, DocConceptRoot>();
											foreach (DocConceptRoot docRoot in docView.ConceptRoots)
											{
												if (docRoot.ApplicableEntity != null)
												{
													if (!listEntity.ContainsKey(docRoot.ApplicableEntity.Name)) // only one concept root per entity per view currently supported
													{
														listEntity.Add(docRoot.ApplicableEntity.Name, docRoot);
													}
												}
											}

											// now generate
											int iRoot = 0;
											foreach (DocConceptRoot docRoot in listEntity.Values)
											{
												iRoot++;

												htmTOC.WriteTOC(3, "<a class=\"listing-link\" href=\"annex/annex-d/" + MakeLinkName(docView) + "/" + MakeLinkName(docRoot.ApplicableEntity) + ".html\" >D.2." + iView.ToString() + "." + iRoot.ToString() + " " + docRoot.ApplicableEntity.Name + "</a>");
												htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">D.2." + iView.ToString() + "." + iRoot.ToString() + " <a href=\"annex-d/" + MakeLinkName(docView) + "/" + MakeLinkName(docRoot.ApplicableEntity) + ".html\" target=\"info\">" + docRoot.ApplicableEntity.Name + "</a></td></tr>");

												string pathRoot = path + @"\annex\annex-d\" + MakeLinkName(docView) + @"\" + MakeLinkName(docRoot.ApplicableEntity) + ".html";
												using (FormatHTM htmRoot = new FormatHTM(pathRoot, mapEntity, mapSchema, included))
												{
													htmRoot.WriteHeader(docRoot.ApplicableEntity.Name, iAnnex, 2, 0, iView, docPublication.Header);
													htmRoot.WriteScript(iAnnex, 2, iView, iRoot);
													htmRoot.WriteLine("<h3 class=\"std\">D.2." + iView.ToString() + "." + iRoot.ToString() + " " + docRoot.ApplicableEntity.Name + "</h3>");

													string diagram = FormatDiagram(docProject, docRoot.ApplicableEntity, docView, listFigures, mapEntity, mapSchema, path);
													htmRoot.WriteLine(diagram);

													htmRoot.WriteFooter(docPublication.Footer);
												}

											}
										}
									}
								}
								break;

							case 'E':
								if (docProject.Examples != null && !Properties.Settings.Default.SkipDiagrams)
								{
									List<DocXsdFormat> listFormats = new List<DocXsdFormat>(xsdFormatBase);
									/*
                                    if (docExample.Views.Count > 0)
                                    {
                                        foreach (DocXsdFormat customformat in docExample.Views[0].XsdFormats)
                                        {
                                            listFormats.Add(customformat);
                                        }
                                    }*/

									List<int> indexpath = new List<int>();
									indexpath.Add(0);
									foreach (DocExample docExample in docProject.Examples)
									{
										GenerateExample(docProject, docPublication, docExample, listFormats, path, indexpath, included, mapEntity, mapSchema, listFigures, listTables, htmTOC, htmSectionTOC, mapFormatData, null, null);
									}
								}
								break;

							case 'F':
								//if (!docPublication.HideHistory)
								{
									for (int iChangeset = 1; iChangeset <= listChangeSets.Count; iChangeset++)
									{
										DocChangeSet docChangeSet = listChangeSets[iChangeset - 1];

										// what's new page
										htmTOC.WriteTOC(1, "<a class=\"listing-link\" href=\"annex/annex-f/" + MakeLinkName(docChangeSet) + "/index.html\" >F." + iChangeset + " " + docChangeSet.Name + "</a>");
										htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\">F." + iChangeset + " <a href=\"annex-f/" + MakeLinkName(docChangeSet) + "/index.html\" target=\"info\" >" + docChangeSet.Name + "</a></td></tr>");
										using (FormatHTM htmWhatsnew = new FormatHTM(path + @"\annex\annex-f\" + MakeLinkName(docChangeSet) + @"\index.html", mapEntity, mapSchema, included))
										{
											htmWhatsnew.WriteHeader(docChangeSet.Name, 3, docPublication.Header);
											htmWhatsnew.WriteScript(iAnnex, iChangeset, 0, 0);
											htmWhatsnew.WriteLine("<h4 class=\"std\">F." + iChangeset + " " + docChangeSet.Name + "</h4>");
											htmWhatsnew.WriteDocumentationMarkup(docChangeSet.DocumentationHtml(), docChangeSet, docPublication, path);
											htmWhatsnew.WriteLinkTo(docPublication, MakeLinkName(docChangeSet), 3);
											htmWhatsnew.WriteFooter(docPublication.Footer);
										}

										// change log for entities
										htmTOC.WriteTOC(1, "<a class=\"listing-link\" href=\"annex/annex-f/" + MakeLinkName(docChangeSet) + "/changelog.html\" >F." + iChangeset + ".1 Entities</a>");
										htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\"><a href=\"annex-f/" + MakeLinkName(docChangeSet) + "/changelog.html\" target=\"info\" >F." + iChangeset + ".1 Entities</a></td></tr>");
										string pathChange = path + @"\annex\annex-f\" + MakeLinkName(docChangeSet) + @"\changelog.html";
										using (FormatHTM htmChange = new FormatHTM(pathChange, mapEntity, mapSchema, included))
										{
											htmChange.WriteHeader(docChangeSet.Name, 3, docPublication.Header);
											htmChange.WriteScript(iAnnex, iChangeset, 1, 0);
											htmChange.WriteLine("<h4 class=\"std\">F." + iChangeset + ".1 Entities</h4>");

											htmChange.WriteLine("<table class=\"gridtable\">");
											htmChange.WriteLine("<tr>" +
												"<th>Item</th>" +
												"<th>SPF</th>" +
												"<th>XML</th>" +
												"<th>Change</th>" +
												"<th>Description</th>" +
												"</tr>");

											foreach (DocChangeAction docChangeItem in docChangeSet.ChangesEntities)
											{
												htmChange.WriteChangeItem(docChangeItem, 0);
											}

											htmChange.WriteLine("</table>");
											htmChange.WriteLinkTo(docPublication, MakeLinkName(docChangeSet) + "-changelog", 3);
											htmChange.WriteFooter(docPublication.Footer);
										}

										// change log for properties
										htmTOC.WriteTOC(1, "<a class=\"listing-link\" href=\"annex/annex-f/" + MakeLinkName(docChangeSet) + "/properties.html\" >F." + iChangeset + ".2 Properties</a>");
										htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\"><a href=\"annex-f/" + MakeLinkName(docChangeSet) + "/properties.html\" target=\"info\" >F." + iChangeset + ".2 Properties</a></td></tr>");
										pathChange = path + @"\annex\annex-f\" + MakeLinkName(docChangeSet) + @"\properties.html";
										using (FormatHTM htmChange = new FormatHTM(pathChange, mapEntity, mapSchema, included))
										{
											htmChange.WriteHeader(docChangeSet.Name, 3, docPublication.Header);
											htmChange.WriteScript(iAnnex, iChangeset, 1, 0);
											htmChange.WriteLine("<h4 class=\"std\">F." + iChangeset + ".2 Properties</h4>");

											htmChange.WriteLine("<table class=\"gridtable\">");
											htmChange.WriteLine("<tr>" +
												"<th>Item</th>" +
												"<th>SPF</th>" +
												"<th>XML</th>" +
												"<th>Change</th>" +
												"<th>Description</th>" +
												"</tr>");

											if (docChangeSet.ChangesProperties != null)
											{
												foreach (DocChangeAction docChangeItem in docChangeSet.ChangesProperties)
												{
													htmChange.WriteChangeItem(docChangeItem, 0);
												}
											}

											htmChange.WriteLine("</table>");
											htmChange.WriteLinkTo(docPublication, MakeLinkName(docChangeSet) + "-properties", 3);
											htmChange.WriteFooter(docPublication.Footer);
										}


										// change log for quantities
										htmTOC.WriteTOC(1, "<a class=\"listing-link\" href=\"annex/annex-f/" + MakeLinkName(docChangeSet) + "/quantities.html\" >F." + iChangeset + ".3 Quantities</a>");
										htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\"><a href=\"annex-f/" + MakeLinkName(docChangeSet) + "/quantities.html\" target=\"info\" >F." + iChangeset + ".3 Quantities</a></td></tr>");
										pathChange = path + @"\annex\annex-f\" + MakeLinkName(docChangeSet) + @"\quantities.html";
										using (FormatHTM htmChange = new FormatHTM(pathChange, mapEntity, mapSchema, included))
										{
											htmChange.WriteHeader(docChangeSet.Name, 3, docPublication.Header);
											htmChange.WriteScript(iAnnex, iChangeset, 1, 0);
											htmChange.WriteLine("<h4 class=\"std\">F." + iChangeset + ".3 Quantities</h4>");

											htmChange.WriteLine("<table class=\"gridtable\">");
											htmChange.WriteLine("<tr>" +
												"<th>Item</th>" +
												"<th>SPF</th>" +
												"<th>XML</th>" +
												"<th>Change</th>" +
												"<th>Description</th>" +
												"</tr>");

											if (docChangeSet.ChangesQuantities != null)
											{
												foreach (DocChangeAction docChangeItem in docChangeSet.ChangesQuantities)
												{
													htmChange.WriteChangeItem(docChangeItem, 0);
												}
											}

											htmChange.WriteLine("</table>");
											htmChange.WriteLinkTo(docPublication, MakeLinkName(docChangeSet) + "-quantities", 3);
											htmChange.WriteFooter(docPublication.Footer);
										}

										// change log for model views
										htmTOC.WriteTOC(1, "<a class=\"listing-link\" href=\"annex/annex-f/" + MakeLinkName(docChangeSet) + "/modelviews.html\" >F." + iChangeset + ".3 Model Views</a>");
										htmSectionTOC.WriteLine("<tr class=\"std\"><td class=\"menu\"><a href=\"annex-f/" + MakeLinkName(docChangeSet) + "/modelviews.html\" target=\"info\" >F." + iChangeset + ".3 Model Views</a></td></tr>");
										pathChange = path + @"\annex\annex-f\" + MakeLinkName(docChangeSet) + @"\modelviews.html";
										using (FormatHTM htmChange = new FormatHTM(pathChange, mapEntity, mapSchema, included))
										{
											htmChange.WriteHeader(docChangeSet.Name, 3, docPublication.Header);
											htmChange.WriteScript(iAnnex, iChangeset, 1, 0);
											htmChange.WriteLine("<h4 class=\"std\">F." + iChangeset + ".3 Model Views</h4>");

											htmChange.WriteLine("<table class=\"gridtable\">");
											htmChange.WriteLine("<tr>" +
												"<th>Item</th>" +
												"<th>SPF</th>" +
												"<th>XML</th>" +
												"<th>Change</th>" +
												"<th>Description</th>" +
												"</tr>");

											if (docChangeSet.ChangesViews != null)
											{
												foreach (DocChangeAction docChangeItem in docChangeSet.ChangesViews)
												{
													// only show if view is in scope
													bool includeview = false;
													foreach (DocModelView docView in docProject.ModelViews)
													{
														if (docChangeItem.Name.Equals(docView.Name))
														{
															if (included == null || included.ContainsKey(docView))
															{
																includeview = true;
																break;
															}
														}
													}

													if (includeview)
													{
														htmChange.WriteChangeItem(docChangeItem, 0);
													}
												}
											}

											htmChange.WriteLine("</table>");
											htmChange.WriteLinkTo(docPublication, MakeLinkName(docChangeSet) + "-modelviews", 3);
											htmChange.WriteFooter(docPublication.Footer);
										}
									}
								}
								break;
						}

						htmSectionTOC.WriteLine(
							"</table>\r\n" +
							"</div>\r\n" +
							"</body>\r\n" +
							"</html>\r\n");
					}

					chAnnex++;
				}

				// bibliography
				try
				{
					using (FormatHTM htmSection = new FormatHTM(path + @"\bibliography.html", mapEntity, mapSchema, included))
					{
						htmSection.WriteHeader("Bibliography", 0, docPublication.Header);

						htmSection.Write(
							"\r\n" +
							"<script type=\"text/javascript\">\r\n" +
							"<!--\r\n" +
							"    parent.index.location.replace(\"blank.html\");\r\n" +
							"//-->\r\n" +
							"</script>\r\n");

						htmSection.WriteLine("<h1>Bibliography</h1>");

						htmSection.WriteLine("<dl>");
						if (docProject.InformativeReferences != null)
						{
							foreach (DocReference docRef in docProject.InformativeReferences)
							{
								htmSection.WriteLine("<dt class=\"bibliographyreference\"><a id=\"" + MakeLinkName(docRef) + "\" id=\"" + MakeLinkName(docRef) + "\">" + docRef.Name + "</a>, <i>" + docRef.DocumentationHtml() + "</i></dt>");
								htmSection.WriteLine("<dd>&nbsp;</dd>");
							}
						}
						htmSection.WriteLine("</dl>");

						htmSection.WriteFooter(docPublication.Footer);
					}
				}
				catch
				{
					htmTOC.ToString();
				}

				htmTOC.WriteLine("</p>");


				// write figures
				htmTOC.WriteLine("<h1 class=\"std\">Figures</h1>");
				htmTOC.WriteLine("<p>");
				htmTOC.WriteContentRefs(listFigures, "Figure");
				htmTOC.WriteLine("</p>");

				htmTOC.WriteLine("<p></p>");

				// write tables
				htmTOC.WriteLine("<h1 class=\"std\">Tables</h1>");
				htmTOC.WriteLine("<p>");
				htmTOC.WriteContentRefs(listTables, "Table");
				htmTOC.WriteLine("</p>");

				htmTOC.WriteFooter(docPublication.Footer);
			}

			worker.ReportProgress(++progressCurrent, "Index");
			if (worker.CancellationPending)
				return null;

			// generate index -- takes very long, so only run when changing
			SortedList<string, DocObject> listIndex = new SortedList<string, DocObject>();
			foreach (string key in mapEntity.Keys)
			{
				listIndex.Add(key, mapEntity[key]);
			}

			using (FormatHTM htmIndex = new FormatHTM(path + "/doc_index.html", mapEntity, mapSchema, included)) // file name "doc_index" required by ISO
			{
				htmIndex.WriteHeader("Index", 0, docPublication.Header);

				htmIndex.Write(
					"\r\n" +
					"<script type=\"text/javascript\">\r\n" +
					"<!--\r\n" +
					"    parent.index.location.replace(\"blank.html\");\r\n" +
					"//-->\r\n" +
					"</script>\r\n");

				htmIndex.WriteLine(
					"<div class=\"not-numbered\">\r\n" +
					"<h1 class=\"std\">Index</h1>\r\n" +
					"<p class=\"std\">\r\n");

				foreach (string key in listIndex.Keys)
				{
					DocObject obj = mapEntity[key];
					if (included == null || included.ContainsKey(obj))
					{
						// build ordered list of references in documentation
						SortedDictionary<string, string> mapRefs = new SortedDictionary<string, string>();

						foreach (string refkey1 in listIndex.Keys)
						{
							string doc = mapEntity[refkey1].Documentation;
							if (doc != null)// && key != refkey) // also include main ref for ISO
							{
								if (refkey1 == key || doc.Contains(key))
								{
									DocObject refobj = (DocObject)mapEntity[refkey1];

									string refnumber = null;
									if (mapNumber != null && mapNumber.TryGetValue(refobj, out refnumber))
									{
										mapRefs.Add(refnumber, refkey1);
									}

								}
							}
						}

						if (mapRefs.Keys.Count > 0)
						{
							htmIndex.WriteLine("<b>" + key + "</b> ");

							// search references of terms in documentation
							string comma = "";
							foreach (string refnumber in mapRefs.Keys)
							{
								string refkey = mapRefs[refnumber];

								DocObject refobj = (DocObject)mapEntity[refkey];
								string display = refobj.Name;//refnumber; // new: use names for bSI; numbers for ISO

								if (refobj is DocPropertyEnumeration)
									continue;
								if (refobj is DocPropertySet)// || refobj is DocPropertyEnumeration)
								{
									htmIndex.Write(comma + "<a class=\"listing-link\" title=\"" + refobj.Name + "\" href=\"schema/" + mapSchema[refkey].ToLower() + "/pset/" + refobj.Name.ToLower() + ".html\">" + display + "</a>");
								}
								else if (refobj is DocQuantitySet)
								{
									htmIndex.Write(comma + "<a class=\"listing-link\" title=\"" + refobj.Name + "\" href=\"schema/" + mapSchema[refkey].ToLower() + "/qset/" + refobj.Name.ToLower() + ".html\">" + display + "</a>");
								}
								else
								{
									htmIndex.Write(comma + "<a class=\"listing-link\" title=\"" + refobj.Name + "\" href=\"schema/" + mapSchema[refkey].ToLower() + "/lexical/" + refobj.Name.ToLower() + ".html\">" + display + "</a>");
								}

								comma = ", ";
							}

							htmIndex.WriteLine("<br />\r\n");
						}
					}
				}

				worker.ReportProgress(++progressCurrent, "Links");
				if (worker.CancellationPending)
					return null;

				// new: incoming links
				foreach (DocPropertyEnumeration docLinkObj in docProject.PropertyEnumerations)
				{
					if (included == null || included.ContainsKey(docLinkObj))
					{
						using (FormatHTM htmLink = new FormatHTM(path + "/link/" + MakeLinkName(docLinkObj) + ".html", mapEntity, mapSchema, included))
						{
							htmLink.WriteLinkPage("../penum/" + MakeLinkName(docLinkObj) + ".html", docPublication);
						}
					}
				}

				foreach (DocSection docLinkSection in docProject.Sections)
				{
					int iSection = docProject.Sections.IndexOf(docLinkSection) + 1;
					using (FormatHTM htmLink = new FormatHTM(path + "/link/chapter-" + iSection.ToString() + ".html", mapEntity, mapSchema, included))
					{
						htmLink.WriteLinkPage("../schema/chapter-" + iSection.ToString() + ".html", docPublication);
					}

					foreach (DocSchema docLinkSchema in docLinkSection.Schemas)
					{
						using (FormatHTM htmLink = new FormatHTM(path + "/link/" + MakeLinkName(docLinkSchema) + ".html", mapEntity, mapSchema, included))
						{
							htmLink.WriteLinkPage("../schema/" + docLinkSchema.Name.ToLower() + "/content.html", docPublication);
						}

						foreach (DocEntity docLinkObj in docLinkSchema.Entities)
						{
							if (included == null || included.ContainsKey(docLinkObj))
							{
								using (FormatHTM htmLink = new FormatHTM(path + "/link/" + MakeLinkName(docLinkObj) + ".html", mapEntity, mapSchema, included))
								{
									htmLink.WriteLinkPage("../schema/" + docLinkSchema.Name.ToLower() + "/lexical/" + MakeLinkName(docLinkObj) + ".html", docPublication);
								}
							}
						}

						foreach (DocType docLinkObj in docLinkSchema.Types)
						{
							if (included == null || included.ContainsKey(docLinkObj))
							{
								using (FormatHTM htmLink = new FormatHTM(path + "/link/" + MakeLinkName(docLinkObj) + ".html", mapEntity, mapSchema, included))
								{
									htmLink.WriteLinkPage("../schema/" + docLinkSchema.Name.ToLower() + "/lexical/" + MakeLinkName(docLinkObj) + ".html", docPublication);
								}
							}
						}

						foreach (DocFunction docLinkObj in docLinkSchema.Functions)
						{
							if (included == null || included.ContainsKey(docLinkObj))
							{
								using (FormatHTM htmLink = new FormatHTM(path + "/link/" + MakeLinkName(docLinkObj) + ".html", mapEntity, mapSchema, included))
								{
									htmLink.WriteLinkPage("../schema/" + docLinkSchema.Name.ToLower() + "/lexical/" + MakeLinkName(docLinkObj) + ".html", docPublication);
								}
							}
						}

						foreach (DocGlobalRule docLinkObj in docLinkSchema.GlobalRules)
						{
							if (included == null || included.ContainsKey(docLinkObj))
							{
								using (FormatHTM htmLink = new FormatHTM(path + "/link/" + MakeLinkName(docLinkObj) + ".html", mapEntity, mapSchema, included))
								{
									htmLink.WriteLinkPage("../schema/" + docLinkSchema.Name.ToLower() + "/lexical/" + MakeLinkName(docLinkObj) + ".html", docPublication);
								}
							}
						}

						foreach (DocPropertySet docLinkObj in docLinkSchema.PropertySets)
						{
							if (included == null || included.ContainsKey(docLinkObj))
							{
								if (docLinkObj.IsVisible())
								{
									using (FormatHTM htmLink = new FormatHTM(path + "/link/" + MakeLinkName(docLinkObj) + ".html", mapEntity, mapSchema, included))
									{
										htmLink.WriteLinkPage("../schema/" + docLinkSchema.Name.ToLower() + "/pset/" + MakeLinkName(docLinkObj) + ".html", docPublication);
									}
								}
							}
						}


						foreach (DocQuantitySet docLinkObj in docLinkSchema.QuantitySets)
						{
							if (included == null || included.ContainsKey(docLinkObj))
							{
								using (FormatHTM htmLink = new FormatHTM(path + "/link/" + MakeLinkName(docLinkObj) + ".html", mapEntity, mapSchema, included))
								{
									htmLink.WriteLinkPage("../schema/" + docLinkSchema.Name.ToLower() + "/qset/" + MakeLinkName(docLinkObj) + ".html", docPublication);
								}
							}
						}
					}
				}

				char chAnnex = 'a';
				foreach (DocAnnex docAnnex in docProject.Annexes)
				{
					using (FormatHTM htmLink = new FormatHTM(path + "/link/annex-" + chAnnex + ".html", mapEntity, mapSchema, included))
					{
						htmLink.WriteLinkPage("../annex/annex-" + chAnnex + ".html", docPublication);
					}

					chAnnex++;
				}

				foreach (DocAnnotation docAnnot in docProject.Annotations)
				{
					using (FormatHTM htmLink = new FormatHTM(path + "/link/" + MakeLinkName(docAnnot) + ".html", mapEntity, mapSchema, included))
					{
						htmLink.WriteLinkPage("../" + MakeLinkName(docAnnot) + ".html", docPublication);
					}
				}

				foreach (DocChangeSet docChange in listChangeSets)
				{
					using (FormatHTM htmLink = new FormatHTM(path + "/link/" + MakeLinkName(docChange) + ".html", mapEntity, mapSchema, included))
					{
						htmLink.WriteLinkPage("../annex/annex-f/" + MakeLinkName(docChange) + "/index.html", docPublication);
					}
					using (FormatHTM htmLink = new FormatHTM(path + "/link/" + MakeLinkName(docChange) + "-changelog.html", mapEntity, mapSchema, included))
					{
						htmLink.WriteLinkPage("../annex/annex-f/" + MakeLinkName(docChange) + "/changelog.html", docPublication);
					}
					using (FormatHTM htmLink = new FormatHTM(path + "/link/" + MakeLinkName(docChange) + "-properties.html", mapEntity, mapSchema, included))
					{
						htmLink.WriteLinkPage("../annex/annex-f/" + MakeLinkName(docChange) + "/properties.html", docPublication);
					}
					using (FormatHTM htmLink = new FormatHTM(path + "/link/" + MakeLinkName(docChange) + "-quantities.html", mapEntity, mapSchema, included))
					{
						htmLink.WriteLinkPage("../annex/annex-f/" + MakeLinkName(docChange) + "/quantities.html", docPublication);
					}
				}

				foreach (DocModelView docView in docProject.ModelViews)
				{
					if (docView.Code != null)
					{
						using (FormatHTM htmLink = new FormatHTM(path + "/link/listing-" + docView.Code.ToLower() + ".html", mapEntity, mapSchema, included))
						{
							htmLink.WriteLinkPage("../annex/annex-a/" + MakeLinkName(docView) + "/index.html", docPublication);
						}
					}
				}

#if false
                foreach (string key in listIndex.Keys)
                {
                    DocObject obj = mapEntity[key];
                    if (included == null || included.ContainsKey(obj))
                    {
                        string schemaname = null;
                        if (mapSchema.TryGetValue(obj.Name, out schemaname))
                        {
                            using (FormatHTM htmLink = new FormatHTM(path + "/link/" + MakeLinkName(obj) + ".html", mapEntity, mapSchema, included))
                            {
                                string linkurl = "../schema/" + schemaname.ToLower() + "/lexical/" + MakeLinkName(obj) + ".html";
                                if (obj is DocPropertySet || obj is DocPropertyEnumeration)
                                {
                                    linkurl = "../schema/" + schemaname.ToLower() + "/pset/" + MakeLinkName(obj) + ".html";
                                }
                                else if (obj is DocQuantitySet)
                                {
                                    linkurl = "../schema/" + schemaname.ToLower() + "/qset/" + MakeLinkName(obj) + ".html";
                                }

                                htmLink.WriteLinkPage(linkurl);
                            }
                        }
                    }
                }
#endif

				// write links for each concept template recursively
				List<DocTemplateDefinition> listLink = new List<DocTemplateDefinition>();
				foreach (DocTemplateDefinition docTemplate in docProject.Templates)
				{
					listLink.Add(docTemplate);
					GenerateTemplateLink(listLink, mapEntity, mapSchema, included, docPublication, path);
					listLink.Clear();
				}

				// write links for each example recursively
				List<DocExample> listLinkExample = new List<DocExample>();
				if (docProject.Examples != null)
				{
					foreach (DocExample docTemplate in docProject.Examples)
					{
						listLinkExample.Add(docTemplate);
						GenerateExampleLink(listLinkExample, mapEntity, mapSchema, included, docPublication, path);
						listLinkExample.Clear();
					}
				}

				htmIndex.WriteLine("</p>");
				htmIndex.WriteFooter(docPublication.Footer);

				return indexPath;
			}
		}

		private static bool checkWebsite(string URL)
		{
			try
			{
				WebClient wc = new WebClient();
				string HTMLSource = wc.DownloadString(URL);
				return true;
			}
			catch (Exception)
			{
				return false;
			}
		}
	}
}