What script is generating the tarball mirror of MDN

RESOLVED FIXED

Status

Infrastructure & Operations
WebOps: Other
P4
normal
RESOLVED FIXED
3 years ago
3 years ago

People

(Reporter: lonnen, Assigned: cyliang)

Tracking

Details

(Whiteboard: [kanban:https://webops.kanbanize.com/ctrl_board/2/2154] [triaged 20120910])

Attachments

(1 attachment)

(Reporter)

Description

3 years ago
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

3 years ago
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}.
(Assignee)

Updated

3 years ago
Assignee: server-ops-webops → cliang
(Assignee)

Comment 2

3 years ago
Created attachment 8688009 [details]
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.

Updated

3 years ago
Whiteboard: [triaged 20120910] → [kanban:https://webops.kanbanize.com/ctrl_board/2/2154] [triaged 20120910]
(Reporter)

Comment 3

3 years ago
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.
(Assignee)

Updated

3 years ago
Status: NEW → RESOLVED
Last Resolved: 3 years ago
Resolution: --- → FIXED
(Reporter)

Comment 4

3 years ago
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
You need to log in before you can comment on or make changes to this bug.