From owner-freebsd-www@FreeBSD.ORG Tue Sep 18 08:08:45 2012 Return-Path: Delivered-To: www@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DBB561065676 for ; Tue, 18 Sep 2012 08:08:44 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id 8F5B68FC0A for ; Tue, 18 Sep 2012 08:08:44 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 8192414E8171 for ; Tue, 18 Sep 2012 10:08:37 +0200 (CEST) X-Virus-Scanned: amavisd-new at server.mypc.hu Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id yqZsNGV2DI3b for ; Tue, 18 Sep 2012 10:08:35 +0200 (CEST) Received: from [192.168.1.100] (D94162B4.catv.pool.telekom.hu [217.65.98.180]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 8F1EB14E809F for ; Tue, 18 Sep 2012 10:08:35 +0200 (CEST) Message-ID: <50582BFE.5040202@FreeBSD.org> Date: Tue, 18 Sep 2012 10:08:30 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:14.0) Gecko/20120713 Thunderbird/14.0 MIME-Version: 1.0 To: www@freebsd.org X-Enigmail-Version: 1.4.4 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: Subject: RFC: htdocs/multimedia improvements X-BeenThere: freebsd-www@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: FreeBSD Project Webmasters List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 18 Sep 2012 08:08:45 -0000 Hi, I've heard complaints from other doc developers about the multimedia section because of the build process and I'm not very satisfied with the current solution either. It takes lots of time to build and if you run make all in htdocs/ it is always built whether there is any change in the corresponding files or not. Besides, the build process is quite messy. It is generated with an ad-hoc perl scripts and probably noone knows how it exactly work except the original author. My proposed improvement uses much simpler XSLT stylesheets to generate the output and they don't any more generate per-tag and per-source pages but a single page with tags that contains the tag cloud and per-tag sections and a single page for sources that contains a source list and per-source sections. In this way we can eliminate generating and installing gazillions of files. I estimate that this approach is fine, since the number of multimedia items aren't growing quickly and even if they grow, it's quite common that older items become unavailable or simply outdated. And nowadays the bandwidth isn't such a bottleneck any more as it used to be. But in case we need per-tag and per-source pages, now it is much easier to modify the XSLT templates to do that. And this solution drastically reduces the build time and files are only rebuilt if there's a change in the source files. The patch is here: kovesdan.org/patches/multimedia.diff And here's a rendered version: http://kovesdan.org/webtest/data/multimedia/multimedia.html Gabor