From 2d8f3fba464411329eadcf41d02d542f2f4e339c Mon Sep 17 00:00:00 2001
From: Xavi Artigas <xavierartigas@yahoo.es>
Date: Tue, 6 Nov 2018 15:21:03 +0100
Subject: [PATCH] doc: Add support for DocFX (C# doc generator)

Summary: Usage instructions in the README file.

Test Plan:
Follow the README to produce the documentation pages.
Point your browser to docfx/_site/index.html to see the results.

Reviewers: lauromoura, bu5hm4n, cedric, myoungwoon, zmike

Reviewed By: lauromoura, bu5hm4n

Subscribers: #reviewers, #committers

Tags: #efl

Maniphest Tasks: T7424

Differential Revision: https://phab.enlightenment.org/D7502
---
 doc/docfx/.gitignore       |  11 ++++
 doc/docfx/README           |  28 +++++++++++
 doc/docfx/api/.gitignore   |   5 ++
 doc/docfx/api/index.md     |   5 ++
 doc/docfx/docfx.json       |  73 +++++++++++++++++++++++++++
 doc/docfx/e-logo-title.png | Bin 0 -> 4441 bytes
 doc/docfx/filterConfig.yml |   7 +++
 doc/docfx/gendoc.sh        |  26 ++++++++++
 doc/docfx/index.md         |   2 +
 doc/docfx/setup.sh         | 100 +++++++++++++++++++++++++++++++++++++
 doc/docfx/toc.yml          |   5 ++
 11 files changed, 262 insertions(+)
 create mode 100644 doc/docfx/.gitignore
 create mode 100644 doc/docfx/README
 create mode 100644 doc/docfx/api/.gitignore
 create mode 100644 doc/docfx/api/index.md
 create mode 100644 doc/docfx/docfx.json
 create mode 100644 doc/docfx/e-logo-title.png
 create mode 100644 doc/docfx/filterConfig.yml
 create mode 100755 doc/docfx/gendoc.sh
 create mode 100644 doc/docfx/index.md
 create mode 100755 doc/docfx/setup.sh
 create mode 100644 doc/docfx/toc.yml

diff --git a/doc/docfx/.gitignore b/doc/docfx/.gitignore
new file mode 100644
index 0000000000..24c4621b34
--- /dev/null
+++ b/doc/docfx/.gitignore
@@ -0,0 +1,11 @@
+###############
+#    folder   #
+###############
+/**/DROP/
+/**/TEMP/
+/**/packages/
+/**/bin/
+/**/obj/
+_site
+images
+articles
diff --git a/doc/docfx/README b/doc/docfx/README
new file mode 100644
index 0000000000..a35110cccf
--- /dev/null
+++ b/doc/docfx/README
@@ -0,0 +1,28 @@
+EFL DocFX SUPPORT
+-----------------
+
+DocFX (https://dotnet.github.io/docfx/) generates documentation HTML pages
+directly from source code and Markdown files for C# projects.
+
+Although significantly slow, it is a simple alternative while our own
+documentation generator for C# is being written.
+
+The scripts in this folder create a documentation site which contains the API
+reference guide and articles with tutorials and guides.
+The API guide is generated from the EFL mono sources, which are generated as
+part of the normal build process.
+The articles are fetched from the EFL www-content repository and adapted to
+DocFX syntax.
+
+USAGE
+-----
+
+First off, build EFL with C# support enabled so the C# sources are generated
+(you will need to have mono 5 installed for this).
+Then, from this folder, run the `setup.sh` script to download and extract the
+DocFX binaries to the `bin` folder, fetch the articles from the `www-content`
+repository and adapt them to the DocFX syntax.
+Finally, run the `gendoc.sh` script (also from this folder) to produce the HTML
+files. First run can take a long time (from 10' to 1h), subsequent runs use
+cached results and take about 5 minutes.
+
diff --git a/doc/docfx/api/.gitignore b/doc/docfx/api/.gitignore
new file mode 100644
index 0000000000..f798527e61
--- /dev/null
+++ b/doc/docfx/api/.gitignore
@@ -0,0 +1,5 @@
+###############
+#  temp file  #
+###############
+*.yml
+.manifest
diff --git a/doc/docfx/api/index.md b/doc/docfx/api/index.md
new file mode 100644
index 0000000000..2965aa1aaa
--- /dev/null
+++ b/doc/docfx/api/index.md
@@ -0,0 +1,5 @@
+---
+uid: api-reference-root
+---
+# EFL C# API reference documentation
+Use the menu on the left to select a namespace or class.
diff --git a/doc/docfx/docfx.json b/doc/docfx/docfx.json
new file mode 100644
index 0000000000..1c5009de69
--- /dev/null
+++ b/doc/docfx/docfx.json
@@ -0,0 +1,73 @@
+{
+  "metadata": [
+    {
+      "src": [
+        {
+          "src": "../..",
+          "files": [
+            "**/*.cs"
+          ]
+        }
+      ],
+      "dest": "api",
+      "filter": "filterConfig.yml",
+      "disableGitFeatures": false,
+      "disableDefaultFilter": false
+    }
+  ],
+  "build": {
+    "content": [
+      {
+        "files": [
+          "api/**.yml",
+          "api/index.md"
+        ]
+      },
+      {
+        "files": [
+          "articles/**.md",
+          "articles/**/toc.yml",
+          "toc.yml",
+          "*.md"
+        ]
+      }
+    ],
+    "resource": [
+      {
+        "files": ["e-logo-title.png"]
+      },
+      {
+        "files": [
+          "images/**"
+        ]
+      }
+    ],
+    "overwrite": [
+      {
+        "files": [
+          "apidoc/**.md"
+        ],
+        "exclude": [
+          "obj/**",
+          "_site/**"
+        ]
+      }
+    ],
+    "globalMetadata": {
+      "_appLogoPath": "e-logo-title.png",
+      "_appFaviconPath": "e-logo-title.png"
+    },
+    "dest": "_site",
+    "globalMetadataFiles": [],
+    "fileMetadataFiles": [],
+    "template": [
+      "default"
+    ],
+    "postProcessors": [],
+    "markdownEngineName": "markdig",
+    "noLangKeyword": false,
+    "keepFileLink": false,
+    "cleanupCacheHistory": false,
+    "disableGitFeatures": false
+  }
+}
diff --git a/doc/docfx/e-logo-title.png b/doc/docfx/e-logo-title.png
new file mode 100644
index 0000000000000000000000000000000000000000..508915f6354c69336ed80af1db3084204960cc12
GIT binary patch
literal 4441
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

literal 0
HcmV?d00001

diff --git a/doc/docfx/filterConfig.yml b/doc/docfx/filterConfig.yml
new file mode 100644
index 0000000000..3fe441259a
--- /dev/null
+++ b/doc/docfx/filterConfig.yml
@@ -0,0 +1,7 @@
+apiRules:
+- include:
+    uidRegex: ^Efl
+- include:
+    uidRegex: ^Eina
+- exclude:
+    uidRegex: ^.*
diff --git a/doc/docfx/gendoc.sh b/doc/docfx/gendoc.sh
new file mode 100755
index 0000000000..99da2d9f18
--- /dev/null
+++ b/doc/docfx/gendoc.sh
@@ -0,0 +1,26 @@
+#!/bin/bash
+
+# This script invokes the locally-installed DocFX to produce the reference
+# documentation. Run it every time EO documentation changes.
+
+# DocFX Step 1: Generate metadata (*.yml) files
+mono bin/docfx.exe metadata docfx.json
+
+# Process the generated metadata files:
+# DocFX uses short names for all <see> links which is inconvenient for us
+# because we have multiple types with the same name in different namespaces
+# ("Object" can be "Efl.Object" or "Efl.Canvas.Object").
+# MarkDown files can add "?displayProperty=fullName" to crefs to show them
+# fully-qualified, but this is stripped out from triple-slash comments in C#
+# source files.
+#
+# This script adds the displayProperty suffix to all cref links from the
+# metadata yml files (by that time links have been turned into <xref href="">
+# tags).
+for f in `ls api/*.yml`; do
+  sed -e 's/\(<xref href="[^"]*\)"/\1?displayProperty=fullName"/g' -i $f
+  sed -e 's/\(<xref href=\\"[^\\]*\)\\"/\1?displayProperty=fullName\\"/g' -i $f
+done;
+
+# DocFX Step 2: Generate HTML files
+mono bin/docfx.exe build docfx.json && echo "Docs ready in the _site folder!"
diff --git a/doc/docfx/index.md b/doc/docfx/index.md
new file mode 100644
index 0000000000..6494f8b893
--- /dev/null
+++ b/doc/docfx/index.md
@@ -0,0 +1,2 @@
+# EFL C# Documentation site
+Use the top menu to access the API reference documentation and the tutorial guides.
diff --git a/doc/docfx/setup.sh b/doc/docfx/setup.sh
new file mode 100755
index 0000000000..eb15787c2e
--- /dev/null
+++ b/doc/docfx/setup.sh
@@ -0,0 +1,100 @@
+#!/bin/bash
+#
+# This script installs DocFX and brings all content pages from EFL's documentation
+# content repository, transforming them from DokuWiki's format to DocFX's.
+# This step only needs to be done once (or every time the content pages change).
+# After this step, you can run the gendoc.sh script as many times as you want,
+# to generate the actual HTML pages, including the reference guide extracted from
+# libefl_mono.dll and libefl_mono.xml
+#
+# This script could be improved a lot, but it gets the job done.
+# Xavi (xartigas@yahoo.es)
+
+#
+# Check mono version since DocFX has been known to fail with mono 4.
+#
+mono_version="$(mono --version | awk '/version/ { print $5 }')"
+if [ $mono_version \< 5 ];
+then
+  echo "Requires at least mono version 5, detected $mono_version"
+  exit 1
+fi;
+
+#
+# Download and extract DocFX
+#
+if [ ! -d "bin" ]; then
+  rm -rf docfx.zip bin
+  wget https://github.com/dotnet/docfx/releases/download/v2.40.4/docfx.zip
+  unzip -q docfx.zip -d bin
+  rm docfx.zip
+else
+  echo "Skipping DocFX download because 'bin' folder already exists."
+fi
+
+#
+# Clone whole Content site
+#
+rm -rf www-content
+git clone --depth 1 git+ssh://git@git.enlightenment.org/website/www-content.git www-content
+
+#
+# Copy all pages related to C# (those inside a folder called 'csharp') to the articles folder
+#
+rm -rf articles
+mkdir articles
+# Copy them
+find www-content -wholename "*/csharp/*.md.txt" -exec cp --parents {} articles \;
+# Except tutorials and guides summary pages (start.md)
+find articles/www-content/pages/develop/tutorials -name "start.md.txt" -exec rm {} \;
+find articles/www-content/pages/develop/guides -name "start.md.txt" -exec rm {} \;
+# Remove the trailing .txt from filenames (DocFX wants only the .md)
+for f in `find articles -name "*.md.txt"`; do mv $f $(echo $f | rev | cut -c5- | rev) ; done
+# Copy all media files to the images folder
+rm -rf images
+mkdir images
+cp -r www-content/media/* images
+# Remove git clone now that we have everything we wanted
+rm -rf www-content
+
+#
+# Parse all Markdown files to adapt them to DocFX
+#
+# Remove special Dokuwiki headers like ~~NOCACHE~~ because DocFX complains about them.
+find articles -name "*.md" | xargs sed -i -e "s/^~~.*~~$//g"
+# Transform media links in articles from /_media/* to ~/images/*
+find articles -name "*.md" | xargs sed -i -e "s#/_media#~/images#g"
+# Transform API root links from /develop/api/ to @api-reference-root (the UID of the API root)
+find articles -name "*.md" | xargs sed -i -e "s#\(\[[^]]*\](\)/develop/api/)#\1xref:api-reference-root)#g"
+# Transform API class links from */api/namespace/class to @Namespace.Class (that should be the UID of the reference page)
+find articles -name "*.md" | xargs sed -i -e "s#\(\[[^]]*\](\)[^)]*/api/\([^/.]*\)/\([^/.]*\))#\1xref:\u\2.\u\3)#g"
+# Point links to Legacy API to the www.enlightenment.org site
+find articles -name "*.md" | xargs sed -i -e "s#\(\[[^]]*\](\)\(/develop/legacy/api/[^)]*)\)#\1https://www.enlightenment.org\2#g"
+# Point the rest of links to /develop/api/* to the root the API, since we don't know how to transform them
+find articles -name "*.md" | xargs sed -i -e "s#\(\[[^]]*\](\)/develop/api/[^)]*)#\1xref:api-reference-root)#g"
+# Add start.md to links pointing to a folder inside ~/develop/
+find articles -name "*.md" | xargs sed -i -e "s#\(\[[^]]*\](/develop/[^)]*/\))#\1start.md)#g"
+# Transform absolute links from /develop/* to ~/articles/www-content/pages/develop/*
+find articles -name "*.md" | xargs sed -i -e "s#\(\[[^]]*\]\)(\(/develop/[^)]*\))#\1(~/articles/www-content/pages\2)#g"
+# Transform page anchor links from [label](#Anchor_Title) to [label](#anchor-title).
+for f in `find articles -name "*.md"`; do
+  awk -v RS=' ' '{ if ($0 ~ ".*\(#.*\)") { gsub( /_/, "-" ); printf "%s ", tolower($0) } else { printf "%s ",$0 } }' $f > /tmp/efl_docfx_setup.tmp
+  mv /tmp/efl_docfx_setup.tmp $f
+done
+
+#
+# Populate articles TOC file from the articles' titles
+#
+cd articles
+rm -f toc.yml
+echo "- name: Setup Guide" >> toc.yml
+echo "  href: www-content/pages/develop/setup/csharp/start.md" >> toc.yml
+echo "- name: Tutorials" >> toc.yml
+echo "  items:" >> toc.yml
+find www-content/pages/develop/tutorials -name "*.md" -exec sh -c "cat {} | grep '^# ' && echo '    href: {}'" \; >> toc.yml
+echo "- name: Guides" >> toc.yml
+echo "  items:" >> toc.yml
+find www-content/pages/develop/guides -name "*.md" -exec sh -c "cat {} | grep '^# ' && echo '    href: {}'" \; >> toc.yml
+sed -i -e "s/^# \(.*\) #/  - name: '\1'/g" toc.yml
+sed -i -e "s/ in C#//g" toc.yml
+cd ..
diff --git a/doc/docfx/toc.yml b/doc/docfx/toc.yml
new file mode 100644
index 0000000000..6aa545deb2
--- /dev/null
+++ b/doc/docfx/toc.yml
@@ -0,0 +1,5 @@
+- name: REFERENCE
+  href: api/
+  homepage: api/index.md
+- name: GUIDES
+  href: articles/