From 13ef1a3b311c6857036e65d5dfafc18a242471ea Mon Sep 17 00:00:00 2001 From: Stephane Desneux Date: Fri, 11 Nov 2016 19:30:50 +0100 Subject: webdocs: adjust layouts deps for UML/FLOW support Change-Id: Ia8d366588a1ac75c3698050953bda7973bb87e55 Signed-off-by: Stephane Desneux --- site/_layouts/doc.html | 271 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 271 insertions(+) create mode 100644 site/_layouts/doc.html (limited to 'site/_layouts/doc.html') diff --git a/site/_layouts/doc.html b/site/_layouts/doc.html new file mode 100644 index 0000000..ed39f8c --- /dev/null +++ b/site/_layouts/doc.html @@ -0,0 +1,271 @@ +--- +layout: base +docs_tab: true +analytics_id: {{site.ganalytics}} + +scripts: + - lib/raphael-min.js + - lib/underscore-min.js + - lib/sequence-diagram-min.js + - lib/flowchart-latest.js + - process-uml.js +--- + +{% include header.html %} + +{% comment %} +set some constants +{% endcomment %} +{% assign ALL_PAGES = site.data.all-pages %} +{% assign DOCSDIR = site.docsurl %} +{% assign TOCSDIR = site.data.tocs %} +{% assign TOCFILE = TOCSDIR[page.tocdir][page.tocfile] %} + +{% capture VERSION_ROOT %}{{DOCSDIR}}/{{page.tocdir}}/{{ page.language }}/{{ page.version }}/{% endcapture %} +{% capture LANGUAGE_ROOT %}{{DOCSDIR}}/{{page.tocdir}}/{{ page.language }}/{% endcapture %} + +{% assign MY_ENTRY = page.url | replace: VERSION_ROOT,"" %} +{% assign my_entry_parts = MY_ENTRY | split: "/" %} + +
+ + + + + +
+
+
+
+ + +
+ +
    + {% include toc_recursive_dropdown.html entries=TOCFILE my_entry=MY_ENTRY version_root=VERSION_ROOT %} +
+
+ + {% comment %} + Show a single edit-link if the page has a specific edit-link. + {% endcomment %} + {% if page.edit_link %} + {{ page.edit_text }} + + {% comment %} + Otherwise, show editing and translating options. + + Edit-links obey the following rules: + + if page in /dev/ or /latest/: + show edit link for /dev/ page in source language + if page not in source language: + show translation link for /dev/ page + else: + show edit link for the page in its version and language + + {% endcomment %} + {% else %} + + {% capture base_edit_link %}{{ site.urls.edit_git }}{{ page.path }}{% endcapture %} + {% capture base_version %}/{{ page.version }}/{% endcapture %} + {% capture base_language %}/{{ page.language }}/{% endcapture %} + {% capture dev_version %}/dev/{% endcapture %} + {% capture src_language %}/{{ site.src_language }}/{% endcapture %} + + {% comment %} + Edit-links for current pages in non-source languages + NOTE: + Pages that are under /dev/ or /latest/ (i.e. site.latest_docs_version) have page.current set to "true". + {% endcomment %} + {% if page.language != site.src_language and page.current %} + + {% comment %} + Compute crowdin link + {% endcomment %} + {% capture page_path_prefix %}docs/{{ page.language }}/{{ page.version }}{% endcapture %} + {% assign page_path_end = page.path | split:"/" | last %} + {% assign crowdin_path = page.path | replace:page_path_prefix,"docs/en/dev" | replace:page_path_end,"" %} + {% capture crowdin_link %}https://crowdin.com/project/cordova/{{ page.language }}#/cordova-docs/{{ crowdin_path }}{% endcapture %} + + {% assign edit_link = base_edit_link | replace:base_language,src_language | replace:base_version,dev_version %} + + {{ page.edit_source_text }} + {{ page.edit_translation_text }} + + {% comment %} + Edit-links for all other pages + {% endcomment %} + {% else %} + + {% comment %} + Edit-link for latest version points to dev instead + {% endcomment %} + {% if page.version == site.latest_docs_version %} + {% assign edit_link = base_edit_link | replace:base_version,dev_version %} + {% else %} + {% assign edit_link = base_edit_link %} + {% endif %} + + {{ page.edit_source_text }} + {% endif %} + {% endif %} + + +
+ + + +
    + {% for other_language_entry in site.data.docs-versions %} + + {% assign other_language_id = other_language_entry[0] %} + {% assign other_language = other_language_entry[1] %} + {% assign other_language_versions = other_language.versions %} + {% assign other_language_name = other_language.name %} + + {% capture other_language_root %}/docs/{{ other_language_id }}/{% endcapture %} + + {% comment %} + Replace only the language part of the URI, thereby redirecting to the same page + in the other language. The page will exist because translations are clones of each other. + {% endcomment %} + {% assign other_language_url = page.url | replace:LANGUAGE_ROOT,other_language_root %} + +
  • + + {% if page.language == other_language_id %} + + {{ other_language_name }} + + {% else %} + {{ other_language_name }} + {% endif %} + +
    • + {% endfor %} +
+
+ + +
+ +
    + + + {% for other_version in site.data.docs-versions[page.language].versions reversed %} +
  • + {% comment %} + Name the latest version as "latest" to take advantage of redirects for "/latest/". + {% endcomment %} + {% if other_version == site.latest_docs_version %} + {% assign other_version_string = "latest" %} + {% else %} + {% assign other_version_string = other_version %} + {% endif %} + + {% capture version_entry_string %} + {{ other_version }} + {% if other_version == site.latest_docs_version %} + ({{ page.latest_text }}) + {% endif %} + {% endcapture %} + + {% comment %} + Replace only the version part of the URI, thereby redirecting to + the same page in the other version. + + NOTE: + This page might not exist in the target version because page + layouts change from version to version + {% endcomment %} + {% capture other_version_root %}/docs/{{ page.language }}/{{ other_version_string }}/{% endcapture %} + {% assign other_version_url = page.url | replace:VERSION_ROOT,other_version_root %} + + {% unless ALL_PAGES contains other_version_url %} + {% assign other_version_url = other_version_root %} + {% endunless %} + + + {% if page.version == other_version %} + + {{ version_entry_string }} + + {% else %} + {{ version_entry_string }} + {% endif %} + +
    • + {% endfor %} +
+
+
+ + {% comment %} + Get URL for this page in the latest version + {% endcomment %} + {% capture latest_root %}/docs/{{ page.language }}/latest/{% endcapture %} + {% assign latest_url = page.url | replace:VERSION_ROOT,latest_root %} + + {% comment %} + If this page doesn't exist, just use root + {% endcomment %} + {% unless ALL_PAGES contains latest_url %} + {% assign latest_url = latest_root %} + {% endunless %} + + + + {% if page.version == 'dev' %} + + {% endif %} + + + {% if page.version != 'dev' and page.version != site.latest_docs_version %} + + {% endif %} + + +
+ {{ content }} +
+
+
+
+ {% include footer_docs.html %} +
+
+
+ + + -- cgit