[SPARK-51124][DOC] Self-host JavaScript and CSS in Spark 3.5.0 website

[LuciferYang]

Execute the following command and regenerate the docs related to version 3.5.0 on v3.5.0 tag

git cherry-pick 31fbf013e7cba1deeb359c0af17295488cf66461
git cherry-pick 3b892bd632502c56c1f76f858a4531f76118024b
git cherry-pick e395f33dd37f212b6e95b08467e95b58acd73d73
git cherry-pick 03f7200d5b6c63a732162b4762f72ac94a64a3f8
cd docs
SKIP_API=1 PRODUCTION=1 bundle exec jekyll build 

then copy all contents in spark/docs/_site to site/docs/3.5.0/ and manually reverted the deletion of the following section:

    <!-- Matomo -->
    <script type="text/javascript">
        var _paq = window._paq = window._paq || [];
        /* tracker methods like "setCustomDimension" should be called before "trackPageView" */
        _paq.push(["disableCookies"]);
        _paq.push(['trackPageView']);
        _paq.push(['enableLinkTracking']);
        (function() {
            var u="https://analytics.apache.org/";
            _paq.push(['setTrackerUrl', u+'matomo.php']);
            _paq.push(['setSiteId', '40']);
            var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
            g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
        })();
    </script>
    <!-- End Matomo Code -->

[dongjoon-hyun]

Is something changed from the previous one, @LuciferYang ?

• [SPARK-51124][DOC] Self-host JavaScript and CSS in Spark 3.5.0 website #588

[dongjoon-hyun]

It seems that this PR deletes less number of lines.

Previous one.

+1,360 −14,205 

This one.

+1,360 −10,333

[LuciferYang]

    <!-- Matomo -->
    <script type="text/javascript">
        var _paq = window._paq = window._paq || [];
        /* tracker methods like "setCustomDimension" should be called before "trackPageView" */
        _paq.push(["disableCookies"]);
        _paq.push(['trackPageView']);
        _paq.push(['enableLinkTracking']);
        (function() {
            var u="https://analytics.apache.org/";
            _paq.push(['setTrackerUrl', u+'matomo.php']);
            _paq.push(['setSiteId', '40']);
            var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
            g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
        })();
    </script>
    <!-- End Matomo Code -->

should be this part

[dongjoon-hyun]

Got it. Let me know when this is ready, @LuciferYang .

[LuciferYang]

@dongjoon-hyun One point needs to be clarified.

1. The PRODUCTION=1 option in SKIP_API=1 PRODUCTION=1 bundle exec jekyll build seems to be ineffective in v3.5.0, as it did not generate the expected

<!-- Matomo -->
    <script type="text/javascript">
        var _paq = window._paq = window._paq || [];
        /* tracker methods like "setCustomDimension" should be called before "trackPageView" */
        _paq.push(["disableCookies"]);
        _paq.push(['trackPageView']);
        _paq.push(['enableLinkTracking']);
        (function() {
            var u="https://analytics.apache.org/";
            _paq.push(['setTrackerUrl', u+'matomo.php']);
            _paq.push(['setSiteId', '40']);
            var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
            g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
        })();
    </script>
    <!-- End Matomo Code -->

section when rebuilding the docs. Therefore, I had to manually revert the deletion of this content in each file based on the generated code to maximize consistency with the previous documentation.

2. If we want the PRODUCTION=1 option to take effect and automatically generate the Matomo section, we need to backport [SPARK-45286][DOCS] Add back Matomo analytics spark#43063 from 3.5.1 to 3.5.0.

3. Currently, I'm not sure why the documentation in the 3.5.0 code repository still contains the Matomo section, I haven't found the effective parameter to generate it automatically.

[dongjoon-hyun]

Got it.

[LuciferYang]

also cc @gengliangwang

[gengliangwang]

Thanks for working on this!

[LuciferYang]

Merged into asf-site. Thanks @gengliangwang and @dongjoon-hyun