public override void InsertRange(int index, BuildGroupTocInfo groupTocInfo)
{
if (groupTocInfo == null || groupTocInfo.Count == 0)
{
return;
}
if (_listTopics == null)
{
_listTopics = new BuildKeyedList <BuildTopicTocInfo>();
}
_listTopics.Insert(index, groupTocInfo.Items);
}
public override void AddRange(BuildGroupTocInfo groupTocInfo)
{
if (groupTocInfo == null || groupTocInfo.Count == 0)
{
return;
}
if (_listTopics == null)
{
_listTopics = new BuildKeyedList <BuildTopicTocInfo>();
}
_listTopics.Add(groupTocInfo.Items);
}
public override void Replace(BuildTopicTocInfo itemOut,
BuildGroupTocInfo groupTocInfo)
{
if (itemOut == null || groupTocInfo == null || groupTocInfo.Count == 0 ||
_listTopics == null)
{
return;
}
int index = this.IndexOf(itemOut);
if (index < 0)
{
BuildTopicTocInfo itemParent = itemOut.Parent;
if (itemParent != null)
{
itemParent.Replace(itemOut, groupTocInfo);
}
return;
}
_listTopics.RemoveAt(index);
_listTopics.Insert(index, groupTocInfo.Items);
}
private void ProcessMarker(ConceptualGroupTocInfo groupTocInfo,
ConceptualMarkerTopic markerTopic, BuildContext context)
{
BuildTopicTocInfo markerTocInfo =
groupTocInfo.Find(markerTopic.TopicId, true);
if (markerTocInfo == null)
{
return;
}
BuildTocContext tocContext = context.TocContext;
BuildGroupTocInfo sourceTocInfo = null;
switch (markerTopic.SourceType)
{
case BuildTocInfoType.Topic:
BuildTopicTocInfo topicTocInfo = tocContext[markerTopic.SourceId];
if (topicTocInfo == null)
{
BuildTopicTocInfo markerParent = markerTocInfo.Parent;
if (markerParent != null)
{
markerParent.Remove(markerTocInfo);
}
else
{
groupTocInfo.Remove(markerTocInfo);
}
}
else
{
groupTocInfo.Replace(markerTocInfo, topicTocInfo);
// Now, exclude the topic from being included in
// the final merging operation...
sourceTocInfo = tocContext.GroupOf(topicTocInfo.Name);
if (sourceTocInfo != null)
{
if (sourceTocInfo.ItemType == BuildTocInfoType.Conceptual)
{
if (_pendindDelete == null)
{
_pendindDelete = new List <PendingDeletePair>();
}
// For the conceptual group, we make room for
// nested markers, and suspend the deletion...
_pendindDelete.Add(new PendingDeletePair(
topicTocInfo, groupTocInfo));
}
else if (sourceTocInfo.ItemType == BuildTocInfoType.Reference)
{
sourceTocInfo.Remove(topicTocInfo);
}
}
}
break;
case BuildTocInfoType.Reference:
case BuildTocInfoType.Conceptual:
sourceTocInfo = tocContext.Items[markerTopic.SourceId];
if (sourceTocInfo == null)
{
//groupTocInfo.Remove(markerTocInfo);
BuildTopicTocInfo markerParent = markerTocInfo.Parent;
if (markerParent != null)
{
markerParent.Remove(markerTocInfo);
}
else
{
groupTocInfo.Remove(markerTocInfo);
}
}
else
{
groupTocInfo.Replace(markerTocInfo, sourceTocInfo);
// Now, exclude the source group from being included in
// the final merging operation...
sourceTocInfo.Exclude = true;
TocMerge sourceToc = _listTocMerges[markerTopic.SourceId];
if (sourceToc != null)
{
sourceToc.IsIncluded = false;
}
}
break;
}
}
private void CustomMergeToc(BuildTopicTocInfo topicParent, TocItem tocItem)
{
TocItemSourceType sourceType = tocItem.SourceType;
if (sourceType == TocItemSourceType.None)
{
return;
}
IBuildNamedList <BuildGroupTocInfo> groupTocItems = _tocContext.Items;
BuildGroupTocInfo groupToc = null;
BuildTopicTocInfo tocInfo = null;
switch (sourceType)
{
case TocItemSourceType.None:
break;
case TocItemSourceType.Group:
groupToc = groupTocItems[tocItem.SourceId];
Debug.Assert(groupToc != null);
break;
case TocItemSourceType.Namespace:
tocInfo = _tocContext[tocItem.SourceId];
break;
case TocItemSourceType.NamespaceRoot:
groupToc = groupTocItems[tocItem.SourceId];
Debug.Assert(groupToc != null);
if (groupToc != null)
{
if (groupToc.IsRooted)
{
tocInfo = groupToc[0];
}
else
{
throw new BuildException(
"The specified reference group does not have a root container.");
}
groupToc = null;
}
break;
case TocItemSourceType.Topic:
tocInfo = _tocContext[tocItem.SourceId];
break;
}
if (groupToc != null)
{
if (!groupToc.Exclude)
{
topicParent.AddRange(groupToc.Items);
}
return;
}
if (tocInfo == null)
{
if (_logger != null)
{
_logger.WriteLine(String.Format(
"The TOC topic for the item '{0}' cannot be found.", tocItem.Name),
BuildLoggerLevel.Warn);
}
return;
}
BuildTopicTocInfo topicToc = null;
if (tocItem.SourceRecursive)
{
topicToc = tocInfo;
}
else
{
topicToc = new BuildTopicTocInfo(tocInfo.Name,
tocInfo.Source, topicParent);
topicToc.Container = tocInfo.Container;
}
topicParent.Add(topicToc);
for (int j = 0; j < tocItem.ItemCount; j++)
{
this.CustomMergeToc(topicToc, tocItem[j]);
}
}
private bool CustomMergeToc(string mergedToc, TocContent tocContent)
{
_tocContext.LoadAll();
IBuildNamedList <BuildGroupTocInfo> groupTocItems = _tocContext.Items;
Debug.Assert(groupTocItems != null && groupTocItems.Count != 0);
int itemCount = tocContent.Count;
List <BuildTopicTocInfo> listToc = new List <BuildTopicTocInfo>();
for (int i = 0; i < itemCount; i++)
{
TocItem tocItem = tocContent[i];
TocItemSourceType sourceType = tocItem.SourceType;
if (sourceType == TocItemSourceType.None)
{
continue;
}
BuildGroupTocInfo groupToc = null;
BuildTopicTocInfo tocInfo = null;
switch (sourceType)
{
case TocItemSourceType.None:
break;
case TocItemSourceType.Group:
groupToc = groupTocItems[tocItem.SourceId];
Debug.Assert(groupToc != null);
break;
case TocItemSourceType.Namespace:
tocInfo = _tocContext[tocItem.SourceId];
break;
case TocItemSourceType.NamespaceRoot:
groupToc = groupTocItems[tocItem.SourceId];
Debug.Assert(groupToc != null);
if (groupToc != null)
{
if (groupToc.IsRooted)
{
tocInfo = groupToc[0];
}
else
{
throw new BuildException(
"The specified reference group does not have a root container.");
}
groupToc = null;
}
break;
case TocItemSourceType.Topic:
tocInfo = _tocContext[tocItem.SourceId];
break;
}
if (groupToc != null)
{
if (!groupToc.Exclude && groupToc.Count != 0)
{
listToc.AddRange(groupToc.Items);
}
continue;
}
if (tocInfo == null)
{
if (_logger != null)
{
_logger.WriteLine(String.Format(
"The TOC topic for the item '{0}' cannot be found.", tocItem.Name),
BuildLoggerLevel.Warn);
}
continue;
}
BuildTopicTocInfo topicToc = null;
if (tocItem.SourceRecursive)
{
topicToc = tocInfo;
}
else
{
topicToc = new BuildTopicTocInfo(tocInfo.Name,
tocInfo.Source, null);
topicToc.Container = tocInfo.Container;
}
listToc.Add(topicToc);
for (int j = 0; j < tocItem.ItemCount; j++)
{
this.CustomMergeToc(topicToc, tocItem[j]);
}
}
if (listToc.Count == 0)
{
if (_logger != null)
{
_logger.WriteLine("The custom merging of the table of contents failed.",
BuildLoggerLevel.Error);
}
return(false);
}
XmlWriter xmlWriter = null;
try
{
XmlWriterSettings writerSettings = new XmlWriterSettings();
writerSettings.Indent = true;
writerSettings.OmitXmlDeclaration = false;
xmlWriter = XmlWriter.Create(mergedToc, writerSettings);
xmlWriter.WriteStartElement("topics");
for (int i = 0; i < listToc.Count; i++)
{
listToc[i].WriteXml(xmlWriter);
}
xmlWriter.WriteEndElement();
xmlWriter.Close();
xmlWriter = null;
return(true);
}
catch (Exception ex)
{
if (xmlWriter != null)
{
xmlWriter.Close();
xmlWriter = null;
}
if (_logger != null)
{
_logger.WriteLine(ex);
}
return(false);
}
}
public PendingDeletePair(BuildTopicTocInfo topic,
BuildGroupTocInfo group)
{
_topic = topic;
_group = group;
}
