From 9308acaa6b8ed92bf428059c9705e433faf4e53b Mon Sep 17 00:00:00 2001 From: Yang Shi Date: Wed, 29 Jul 2020 12:21:42 -0700 Subject: [PATCH] remove other language bindings section from website api page (#18783) * remove other language bindings section from api page * remove language binding docs redirect * add call for contribution banner * modify call for contribution wording Co-authored-by: Aaron Markham * more wording modification Co-authored-by: Aaron Markham * add hyperlink to 1.x version in banner * add reference to the C api deprecation github issue Co-authored-by: Aaron Markham --- docs/static_site/src/.htaccess | 9 --- docs/static_site/src/_sass/minima/_docs.scss | 10 +++ docs/static_site/src/pages/api/api.html | 72 ++------------------ 3 files changed, 14 insertions(+), 77 deletions(-) diff --git a/docs/static_site/src/.htaccess b/docs/static_site/src/.htaccess index dabc51a41f2b..d8467ab2142e 100644 --- a/docs/static_site/src/.htaccess +++ b/docs/static_site/src/.htaccess @@ -28,15 +28,6 @@ RewriteCond %{HTTP_REFERER} !mxnet.apache.org RewriteCond %{HTTP_REFERER} !mxnet.incubator.apache.org RewriteRule ^(.*)$ /versions/1.6/$1 [r=307,L] -# TODO temporary fix for issue #18604 -Redirect 302 /api/r/docs/api/R-package/build/mxnet-r-reference-manual.pdf https://mxnet-public.s3.us-east-2.amazonaws.com/docs/v1.x/mxnet-r-reference-manual.pdf -Redirect 302 /api/scala/docs/api/ /versions/1.6/api/scala/docs/api/ -Redirect 302 /api/java/docs/api/ /versions/1.6/api/java/docs/api/ -Redirect 302 /api/clojure/docs/api/ /versions/1.6/api/clojure/docs/api/ -Redirect 302 /api/cpp/docs/api/ /versions/1.6/api/cpp/docs/api/ -Redirect 302 /api/julia/docs/api/ /versions/1.6/api/julia/docs/api/ -Redirect 302 /api/julia/docs/api/#tutorials /versions/1.6/api/julia/docs/api/#tutorials - # Redirect Chinese visitors to Chinese CDN, temporary solution for slow site speed in China RewriteCond %{ENV:GEOIP_COUNTRY_CODE} ^CN$ RewriteCond %{HTTP_HOST} !cdn diff --git a/docs/static_site/src/_sass/minima/_docs.scss b/docs/static_site/src/_sass/minima/_docs.scss index f628740862ae..85e4c12c081e 100644 --- a/docs/static_site/src/_sass/minima/_docs.scss +++ b/docs/static_site/src/_sass/minima/_docs.scss @@ -85,3 +85,13 @@ padding-top: 20px; padding-bottom: 20px; } + +.language-binding-banner { + border: 1px solid transparent; + border-radius: .25rem; + color: #856404; + padding: .75rem 1.25rem; + margin-bottom: 1rem; + background-color: #fff3cd; + border-color: #ffeeba; +} diff --git a/docs/static_site/src/pages/api/api.html b/docs/static_site/src/pages/api/api.html index b055072c40c4..bd0d8bfaa510 100644 --- a/docs/static_site/src/pages/api/api.html +++ b/docs/static_site/src/pages/api/api.html @@ -21,55 +21,6 @@ tutorial_link: /api/python/docs/tutorials icon: /assets/img/python_logo.svg tag: python -- title: Scala - guide_link: /api/scala.html - api_link: /api/scala/docs/api - tutorial_link: /api/scala/docs/tutorials - description: - icon: /assets/img/scala_logo.svg - tag: scala -- title: Java - guide_link: /api/java.html - api_link: /api/java/docs/api - tutorial_link: /api/java/docs/tutorials - description: - icon: /assets/img/java_logo.svg - tag: java -- title: Clojure - guide_link: /api/clojure - api_link: /api/clojure/docs/api - tutorial_link: /api/clojure/docs/tutorials - description: - icon: /assets/img/clojure_logo.svg - tag: clojure -- title: C/C++ - guide_link: /api/cpp - api_link: /api/cpp/docs/api - tutorial_link: /api/cpp/docs/tutorials - description: - icon: /assets/img/cpp_logo.svg - tag: cpp -- title: Julia - guide_link: /api/julia - api_link: /api/julia/docs/api - tutorial_link: /api/julia/docs/api/#tutorials - description: - icon: /assets/img/julia_logo.svg - tag: julia -- title: R - guide_link: /api/r - api_link: /api/r/docs/api/R-package/build/mxnet-r-reference-manual.pdf - tutorial_link: /api/r/docs/tutorials - description: - icon: /assets/img/R_logo.svg - tag: r -- title: Perl - guide_link: /api/perl - api_link: https://metacpan.org/release/AI-MXNet - tutorial_link: /api/perl/docs/tutorials - description: - icon: /assets/img/perl_logo.svg - tag: perl --- @@ -123,26 +74,11 @@

Python-first API

{%- endfor -%}

Other Bindings

-{%- for doc in page.docs -%} - {%- if doc.tag != 'python' -%} -
-
-
- -
-
- {{doc.title}} Guide › -
-
- {{doc.title}} Tutorials › -
-
- {{doc.title}} API Reference › -
-
+
+

Call for Contribution

+ The Clojure, Java, Julia, R, and Scala language bindings of MXNet v1.x were removed in v2.x due to some C APIs being deprecated and the bindings rely on the deprecated APIs. You can still use these language bindings in v1.x. + MXNet's new C APIs in v2.x can be used to reestablish your preferred language binding. Your contribution is welcome!
- {%- endif -%} -{%- endfor -%}