From 57c2af613ca61ba937fbf0491ac6392415e80378 Mon Sep 17 00:00:00 2001 From: Christoph Haas Date: Sun, 1 Nov 2020 23:26:13 +0100 Subject: [PATCH] Nicer about page in two-column layout --- app/views/welcome/about.slim | 471 +++++++++++++++++++---------------- 1 file changed, 257 insertions(+), 214 deletions(-) diff --git a/app/views/welcome/about.slim b/app/views/welcome/about.slim index ab5969b..8f7f4ea 100644 --- a/app/views/welcome/about.slim +++ b/app/views/welcome/about.slim @@ -1,243 +1,286 @@ -h1 About this web site +.grid-x.grid-padding-x.grid-padding-y -p - | - This is a public repository of screenshots taken from applications contained - in the Debian GNU/Linux distribution and its derivatives like Ubuntu. It was - created to help getting an impression of what a certain software will look - like on your desktop before you install it. Everybody can take screenshots and - upload them. Our admin team will just review your changes before they become - publicly visible. + .cell.large-4 -h2 Who runs this site? + h2 About this web site -p - ' This site is run by Christoph Haas (haas). Paul Wise (pabs) helps with the - ' moderation of new uploads. However almost all of the screenshots were - ' contributed by countless volunteers of the open-source community. - ' - ' Feel free to leave - a href="mailto:haas@debian.org" feedback? + .cell.large-8 -a name='cookies' -h2 Cookies and privacy + p + | + This is a public repository of screenshots taken from applications contained + in the Debian GNU/Linux distribution and its derivatives like Ubuntu. It was + created to help getting an impression of what a certain software will look + like on your desktop before you install it. Everybody can take screenshots and + upload them. Our admin team will just review your changes before they become + publicly visible. -p - ' I am very concerned with privacy myself. So this site stores as - ' little information about your stay as possible. That is: + .cell.large-4 -ul - li - em - 'Cookies. - | - Only if and when you upload a screenshot the website will send your - browser a session cookie. That allows you to manage your own uploads - while the cookie is valid. You can still upload screenshots even - if you reject the cookie. - li - em - 'Log files. - | - This web site is served by the nginx web server software. - It creates one line for every request that you make which contains - the current date and time, your IP address, the URL you requested, - the user agent (browser) identification string and the referer URL - (if you followed a link from another web site to get here). - This information is used to resolve technical issues regarding the operation - of this web application by optimizing the code and fine-tuning caching. - It is also used to count how often a certain software package has - been viewed so the website can find out which software is most relevant - and display it first in search results. - Detailed log files will get deleted automatically after 14 days. - li - em - 'Privacy. - | - Under no circumstance will information about your person be - analysed or given to other people. I am happy to have you here as my guest. + h2 Who runs this site? -h2 What is your motivation of running this site? -p - | - Do you wonder why this web site has been running for so many years - obviously costing time and money? It's one of my pet projects and - it is fun to develop and operate it. It was not conceived to make - a profit from it. I'm just glad if you like the idea. - If you feel you want to give back something then help the Debian - project. + .cell.large-8 -h2 Which software packages are listed? + p + ' This site has been created and is run and paid for + ' by Christoph Haas (haas). Paul Wise (pabs) helps with the + ' moderation of new uploads. However almost all of the screenshots were + ' contributed by countless volunteers of the open-source community. + ' + ' Feel free to leave + a href="mailto:haas@debian.org" feedback? -p - | - I import the package repositories from various Linux - distributions once a day. However we already filter out packages that - we think would not be able to have a meaningful screenshot. - Like libraries or documentation or developer packages. So it may happen - that you a package is not found on this web sites although it may be - available in your favorite Linux distribution. Just let me know if you - are missing packages. + .cell.large-4 -p - ' The repositories that I am scanning frequently are: + a name='cookies' + h2 Cookies and privacy - ul - - @package_sources.each do |repo| + .cell.large-8 + + p + ' I am very concerned with privacy myself. So this site stores as + ' little information about your stay as possible. That is: + + ul li - a href=repo[:url] =repo[:description] - -h2 Who is using this site? - -p - | - Many users interested in Linux distributions and their applications visit - this site either to look for specific pieces of software for certain use - cases or just to see if there are any new applications they may have missed out on. - And then there are several applications and web sites that use the screenshots - from this site: - ul - li Ubuntu Software application - li Benjamin Mesing's Packagesearch application - li - a href="https://packages.debian.org" packages.debian.org - li - a href="http://packages.ubuntu.com" packages.ubuntu.com - -h2 How you can use the screenshots - -p - ' You can use the screenshots on your own website. Some useful URLs: - - ul - li - // TODO: Use actual virtual host name here instead of hardcoding screenshots.debian.net - ' http://screenshots.debian.net/packages - br - ' (List of all packages with screenshots) - li - ' http://screenshots.debian.net/package/PACKAGENAME - br - ' (Page with details and screenshots for a certain package) - li - ' http://screenshots.debian.net/thumbnail/PACKAGENAME - br + em + 'Cookies. | - (Returns a thumbnail (160x120 pixels or less) of the package's most - recently uploaded - screenshot. If no screenshot was found then a dummy image will be returned - along with the HTTP code 404.) - li - ' http://screenshots.debian.net/screenshot/PACKAGENAME - br + Only if and when you upload a screenshot the website will send your + browser a session cookie. That allows you to manage your own uploads + while the cookie is valid. You can still upload screenshots even + if you reject the cookie. + li + em + 'Log files. | - (Returns a screenshot (800x600 pixels or less) of a package. If no - screenshot was found then a dummy image will be returned along with the - HTTP code 404.) - - p - ' If you would like to get a complete list of packages or screenshots in JSON - ' format then use one of these URLs: - - ul - li - ' http://screenshots.debian.net/json/package/PACKAGENAME - br + This web site is served by the nginx web server software. + It creates one line for every request that you make which contains + the current date and time, your IP address, the URL you requested, + the user agent (browser) identification string and the referer URL + (if you followed a link from another web site to get here). + This information is used to resolve technical issues regarding the operation + of this web application by optimizing the code and fine-tuning caching. + It is also used to count how often a certain software package has + been viewed so the website can find out which software is most relevant + and display it first in search results. + Detailed log files will get deleted automatically after 14 days. + li + em + 'Privacy. | - Returns a JSON structure containing the URLs to the thumbnails and - full-size images of the screenshots available on this site. - li - ' http://screenshots.debian.net/json/packages - br - | - Returns a JSON structure containing information about all packages - but not the actual screenshots. - The returned object is huge so please use it sparingly. - li - ' http://screenshots.debian.net/json/screenshots - br - | - Returns a JSON structure containing informatoin about all packages - and one screenshot's URL each. There may be further screenshots that are - not included. - li - ' http://screenshots.debian.net/json/packages-without-screenshots - br - | - Returns a JSON structure containing the names of all packages - that still lack screenshots. If you want to help contributing - then this data can be useful. + Under no circumstance will information about your person be + analysed or given to other people. I am happy to have you here as my guest. -h2 Uploading new screenshots + .cell.large-4 -p - | - Whether you are a developer or not - we appreciate if you upload screenshots. - See if your favorite package does not yet have a screenshot and - upload one. + h2 What is your motivation of running this site? -h2 Why isn't this a debian.org service? + .cell.large-8 -p - | - Often experimental services start as something.debian.net. After a while they - are handed over to the trusted hands of the Debian sysadmin team to be operated - on Debian servers. This works best for simple services that are easy to deploy. - The web application behind this website has been written in Ruby-on-Rails - and uses sophisticated database and caching configuration to make it - fast. That has been a showstopper in the past. Although the site is running - as a one-man show it has proven to be very stable and fast over a period of - many years. + p + | + Do you wonder why this web site has been running for so many years + obviously costing time and money? It's one of my pet projects and + it is fun to develop and operate it. It was not conceived to make + a profit from it. I'm just glad if you like the idea. + If you feel you want to give back something then help the Debian + project. -h2 Is this web application available as a Debian package? + .cell.large-4 -p - | - I have been asked why the web application was not simply put into - a Debian package so everybody can install their own copy. First of all it - is pretty complex and creating a package from it would be time-consuming. - And the web application was specifically created to operate this web site. - Running a private copy of it would not really make much sense. + h2 Which software packages are listed? -h2 Can I see the source code of this web application? + .cell.large-8 -p - | - Valid question. I am not a professional Rails developer so I was - reluctant to publish the source code. In fact I feared it would - attract people with bad intentions rather than contributors. - Yes, that is a weak reason. So after the next major update I will - add the Git URL here so you can get the source code and start - critisizing me. :) + p + | + I import the package repositories from various Linux + distributions once a day. However we already filter out packages that + we think would not be able to have a meaningful screenshot. + Like libraries or documentation or developer packages. So it may happen + that you a package is not found on this web sites although it may be + available in your favorite Linux distribution. Just let me know if you + are missing packages. -h2 Statistics + p + ' The repositories that I am scanning frequently are: -p - // TODO: Use real values - ' There are currently #{@package_count} software packages in the database. - / ' 3798 of them have screenshots. - / ' That makes a total of 7.8%. - ' And #{@screenshot_count} screenshots have been uploaded. + ul + - @package_sources.each do |repo| + li + a href=repo[:url] =repo[:description] -/ p -/ // TODO: Use plot about upload statistics -/ ' (Number of screenshots uploaded each month.) + .cell.large-4 -h2 Who is behind this site? + h2 Who is using this site? -p - | - This site has been developed and is maintained by Christoph Haas. - It runs on a web application called debshots that was written in Ruby-on-Rails. - debshots also uses a PostgreSQL database, the jQuery Javascript library - and the Zurb Foundation toolkit. - The person responsible for this site is: + .cell.large-8 -p - 'Christoph Haas - br - 'Oldesloer Straße 14a - br - '23843 Rümpel - br - 'Email contact: email@christoph-haas.de + p + | + Many users interested in Linux distributions and their applications visit + this site either to look for specific pieces of software for certain use + cases or just to see if there are any new applications they may have missed out on. + And then there are several applications and web sites that use the screenshots + from this site: + ul + li Ubuntu Software application + li Benjamin Mesing's Packagesearch application + li + a href="https://packages.debian.org" packages.debian.org + li + a href="http://packages.ubuntu.com" packages.ubuntu.com + + .cell.large-4 + + h2 How you can use the screenshots + + .cell.large-8 + + p + ' You can use the screenshots on your own website. Some useful URLs: + + ul + li + // TODO: Use actual virtual host name here instead of hardcoding screenshots.debian.net + ' http://screenshots.debian.net/packages + br + ' (List of all packages with screenshots) + li + ' http://screenshots.debian.net/package/PACKAGENAME + br + ' (Page with details and screenshots for a certain package) + li + ' http://screenshots.debian.net/thumbnail/PACKAGENAME + br + | + (Returns a thumbnail (160x120 pixels or less) of the package's most + recently uploaded + screenshot. If no screenshot was found then a dummy image will be returned + along with the HTTP code 404.) + li + ' http://screenshots.debian.net/screenshot/PACKAGENAME + br + | + (Returns a screenshot (800x600 pixels or less) of a package. If no + screenshot was found then a dummy image will be returned along with the + HTTP code 404.) + + p + ' If you would like to get a complete list of packages or screenshots in JSON + ' format then use one of these URLs: + + ul + li + ' http://screenshots.debian.net/json/package/PACKAGENAME + br + | + Returns a JSON structure containing the URLs to the thumbnails and + full-size images of the screenshots available on this site. + li + ' http://screenshots.debian.net/json/packages + br + | + Returns a JSON structure containing information about all packages + but not the actual screenshots. + The returned object is huge so please use it sparingly. + li + ' http://screenshots.debian.net/json/screenshots + br + | + Returns a JSON structure containing informatoin about all packages + and one screenshot's URL each. There may be further screenshots that are + not included. + li + ' http://screenshots.debian.net/json/packages-without-screenshots + br + | + Returns a JSON structure containing the names of all packages + that still lack screenshots. If you want to help contributing + then this data can be useful. + + .cell.large-4 + + h2 Uploading new screenshots + + .cell.large-8 + + p + | + Whether you are a developer or not - we appreciate if you upload screenshots. + See if your favorite package does not yet have a screenshot and + upload one. + + .cell.large-4 + + h2 Why isn't this a debian.org service? + + .cell.large-8 + + p + | + Often experimental services start as something.debian.net. After a while they + are handed over to the trusted hands of the Debian sysadmin team to be operated + on Debian servers. This works best for simple services that are easy to deploy. + The web application behind this website has been written in Ruby-on-Rails + and uses sophisticated database and caching configuration to make it + fast. That has been a showstopper in the past. Although the site is running + as a one-man show it has proven to be very stable and fast over a period of + many years. + + .cell.large-4 + + h2 Can I see the source code of this web application? + + .cell.large-8 + + p + ' The source code is available at + a href="https://salsa.debian.org/debian/debshots" + ' salsa.debian.net + + .cell.large-4 + + h2 Statistics + + .cell.large-8 + + p + // TODO: Use real values + ' There are currently #{@package_count} software packages in the database. + / ' 3798 of them have screenshots. + / ' That makes a total of 7.8%. + ' And #{@screenshot_count} screenshots have been uploaded. + + / p + / // TODO: Use plot about upload statistics + / ' (Number of screenshots uploaded each month.) + + .cell.large-4 + + h2 Who is behind this site? + + .cell.large-8 + + p + | + This site has been developed and is maintained by Christoph Haas + as part of the Debian project. + + .cell.large-4 + + h2 What technology do you use for this site? + + .cell.large-8 + + ul + li A custom made web application called debshots + li Ruby-on-Rails + li Shrine for file management + li PostgreSQL to store metadata + li The Zurb Foundation web toolkit + li Icons from Font Awesome + li Nginx as a caching reverse proxy + li Debian as an operating system to run everything on + li The Netcup hosting company