/// <summary>
 /// Prepares all links in a LinkItemCollection for output
 /// by filtering out inaccessible links and ensures all links are correct.
 /// </summary>
 /// <param name="linkItemCollection">The collection of links to prepare.</param>
 /// <returns>A prepared and filtered list of LinkItems</returns>
 public static IEnumerable <LinkItem> ToPreparedLinkItems(this LinkItemCollection linkItemCollection)
 {
     return(linkItemCollection.ToPreparedLinkItems(false));
 }