1224953 - What script is generating the tarball mirror of MDN

Status: RESOLVED FIXED

(Infrastructure & Operations Graveyard :: WebOps: Other, task, P4)

Description

[Lonnen :lonnen]

What exactly is generating the tarball mirror of MDN? 

https://bugzilla.mozilla.org/show_bug.cgi?id=757461 has the initial script and quite a few modifications.

Comment 1

[Andreas Eibach]

As far as it looks, this script will also work for so-called "end-users" then?

I mean those who do not have any access to Mozilla's internal server cluster but merely to 'The Internet' {tm}.

Comment 2

[C. Liang [:cyliang]]

Attachment: tarball-generate.sh

I've attached the latest copy of the script (tarball-generate.sh) to this bug.  

While, technically, anyone can chose to run this script against the live MDN site, I expect that it'd be 1) slow and 2) take up a good chunk of disk space.  (See bug 1041871.)  

I hadn't seen the traffic at the tail end of bug 757461.  If there is no need for this script, I can excise it.

Comment 3

[Lonnen :lonnen]

Thanks C!

Andreas -- this script is a halfway measure. When we introduced a CDN this script stopped downloading the static assets and left web links to them instead. You get the content but none of the styling.

I recommend instead using third-party tools like Dash (for Mac OS) and Zeal (for Linux and Windows). Kapeli also publishes offline MDN docs covering HTML, CSS, JavaScript, SVG, and XSLT.

Comment 4

[Lonnen :lonnen]

for posterity: https://github.com/lonnen/mdn-static-mirror

I put together a static mirror script that started from this one and improved it a bit by grabbing the CDN. It's pretty specific to the needs of the org for which I wrote it (airgapped MDN, en-US only, no demo studio, no search yet). It may be a jumping off point for some future offline project.

That said, unless you need an air-gapped MDN install with no working accounts, search, or history, you are MUCH better off using one of the personal offline MDN tools described in the about page: https://developer.mozilla.org/en-US/docs/MDN/About