Nicer about page in two-column layout
This commit is contained in:
parent
6ddf9ff48c
commit
57c2af613c
1 changed files with 257 additions and 214 deletions
|
|
@ -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 <em>Ubuntu Software</em> application
|
||||
li Benjamin Mesing's <em>Packagesearch</em> 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 <em>debshots</em> 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 <em>Ubuntu Software</em> application
|
||||
li Benjamin Mesing's <em>Packagesearch</em> 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 <em>debshots</em>
|
||||
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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue