mcs/tools/mdoc/Mono.Documentation/webdoc.cs

   1 //
   2 // webdoc.cs
   3 //
   4 // Author:
   5 //   Jonathan Pryor  <jpryor@novell.com>
   6 //
   7 // Copyright (c) 2009 Novell, Inc. (http://www.novell.com)
   8 //
   9 // Permission is hereby granted, free of charge, to any person obtaining
  10 // a copy of this software and associated documentation files (the
  11 // "Software"), to deal in the Software without restriction, including
  12 // without limitation the rights to use, copy, modify, merge, publish,
  13 // distribute, sublicense, and/or sell copies of the Software, and to
  14 // permit persons to whom the Software is furnished to do so, subject to
  15 // the following conditions:
  16 //
  17 // The above copyright notice and this permission notice shall be
  18 // included in all copies or substantial portions of the Software.
  19 //
  20 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  21 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  22 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  23 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  24 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  25 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  26 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  27 //
  28
  29 using System;
  30 using System.Collections.Generic;
  31 using System.Diagnostics;
  32 using System.IO;
  33 using System.Linq;
  34 using System.Text;
  35 using System.Web;
  36
  37 using Monodoc;
  38
  39 using Mono.Options;
  40 using Mono.Rocks;
  41
  42 namespace Mono.Documentation
  43 {
  44         public class MDocExportWebdocHtml : MDocCommand
  45         {
  46                 public override void Run (IEnumerable<string> args)
  47                 {
  48                         string dir = null;
  49                         var options = new OptionSet () {
  50                         { "o|out=",
  51                                 "The {DIRECTORY} to place the generated files and directories.\n\n" +
  52                                 "If not specified, defaults to\n`dirname FILE`/cache/`basename FILE .tree`.",
  53                                 v => dir = v },
  54                         };
  55                         List<string> files = Parse (options, args, "export-html-webdoc",
  56                                         "[OPTIONS]+ FILES",
  57                                         "Export mdoc documentation within FILES to HTML for use by ASP.NET webdoc.\n\n" +
  58                                         "FILES are .tree or .zip files as produced by 'mdoc assemble'.");
  59                         if (files == null)
  60                                 return;
  61                         if (files.Count == 0)
  62                                 Error ("No files specified.");
  63                         HelpSource.use_css = true;
  64                         HelpSource.FullHtml = false;
  65                         SettingsHandler.Settings.EnableEditing = false;
  66                         foreach (var basePath in
  67                                         files.Select (f =>
  68                                                         Path.Combine (Path.GetDirectoryName (f), Path.GetFileNameWithoutExtension (f)))
  69                                         .Distinct ()) {
  70                                 Console.WriteLine ("# Processing BasePath={0}", basePath);
  71                                 string treeFile = basePath + ".tree";
  72                                 string zipFile  = basePath + ".zip";
  73                                 if (!Exists (treeFile) || !Exists (zipFile))
  74                                         continue;
  75                                 Console.WriteLine ("# Tree file={0}", treeFile);
  76                                 Tree tree = new Tree (null, treeFile);
  77                                 RootTree docRoot = RootTree.LoadTree ();
  78                                 string helpSourceName = Path.GetFileName (basePath);
  79                                 HelpSource hs = docRoot.HelpSources.Cast<HelpSource> ()
  80                                         .FirstOrDefault (h => h.Name == helpSourceName);
  81                                 if (hs == null) {
  82                                         throw new Exception ("Only installed .tree and .zip files are supported.");
  83                                 }
  84                                 string outDir = dir ?? Path.Combine (
  85                                                 Path.Combine (Path.GetDirectoryName (basePath), "cache"),
  86                                                 Path.GetFileName (basePath));
  87                                 Console.WriteLine ("# outDir={0}", outDir);
  88                                 Directory.CreateDirectory (outDir);
  89                                 foreach (Node node in tree.TraverseDepthFirst<Node, Node> (t => t, t => t.Nodes.Cast<Node> ())) {
  90                                         var url = node.URL;
  91                                         Console.WriteLine ("# NodeUrl={0}", url);
  92                                         if (string.IsNullOrEmpty (url))
  93                                                 continue;
  94                                         var file = Path.Combine (outDir,
  95                                                         HttpUtility.UrlEncode (url).Replace ('/', '+').Replace ("*", "%2a"));
  96                                         Console.WriteLine ("# file={0}", file);
  97                                         using (var o = File.AppendText (file)) {
  98                                                 Node _;
  99                                                 o.Write (hs.GetText (url, out _));
 100                                         }
 101                                 }
 102                         }
 103                 }
 104
 105                 bool Exists (string file)
 106                 {
 107                         if (!File.Exists (file)) {
 108                                         Message (TraceLevel.Error,
 109                                                         "mdoc: Could not find file: {0}", file);
 110                                         return false;
 111                         }
 112                         return true;
 113                 }
 114         }
 115 }