[jira] [Created] (NIFI-7826) Embedded NiFi documentation import external resources

["Pierre Villard (Jira)" <ji...@apache.org>]

Pierre Villard created NIFI-7826:
------------------------------------

             Summary: Embedded NiFi documentation import external resources
                 Key: NIFI-7826
                 URL: https://issues.apache.org/jira/browse/NIFI-7826
             Project: Apache NiFi
          Issue Type: Improvement
          Components: Documentation & Website
            Reporter: Pierre Villard


The embedded documentation is trying to load external resources over the internet. If external access to the internet is not allowed, the documentation might only load after DNS resolution times out. This is not preventing the documentation to be correctly loaded but it may take an unnecessary long time to do so.

It appears that this is because of two things:
 * font-awesome CSS file
 * and fonts

In nifi-docs:
{code:java}
src/main/asciidoc/asciidoc-mod.css:@import "https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400";{code}
And when the documentation is generated:
{code:java}
target/generated-docs/administration-guide.html:<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.2.0/css/font-awesome.min.css">
target/generated-docs/toolkit-guide.html:<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.2.0/css/font-awesome.min.css">
target/generated-docs/record-path-guide.html:<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.2.0/css/font-awesome.min.css">
target/generated-docs/overview.html:<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.2.0/css/font-awesome.min.css">
target/generated-docs/user-guide.html:<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.2.0/css/font-awesome.min.css">
target/generated-docs/expression-language-guide.html:<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.2.0/css/font-awesome.min.css">
target/generated-docs/getting-started.html:<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.2.0/css/font-awesome.min.css">
target/generated-docs/walkthroughs.html:<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.2.0/css/font-awesome.min.css">
target/generated-docs/developer-guide.html:<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.2.0/css/font-awesome.min.css">
target/generated-docs/nifi-in-depth.html:<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.2.0/css/font-awesome.min.css">{code}
AFAICT it'd be OK from a license perspective to include the corresponding files in the convenience binaries we provide.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)