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)
