debshots/app/views/welcome/about.slim
2026-03-01 22:11:43 +01:00

295 lines
9.5 KiB
Text

.grid-x.grid-padding-x.grid-padding-y
.cell.large-4
h2 About this web site
.cell.large-8
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?
.cell.large-8
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?
.cell.large-4
a name='cookies'
h2 Cookies and privacy
.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
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.
.cell.large-4
h2 What is your motivation of running this site?
.cell.large-8
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-4
h2 Which software packages are listed?
.cell.large-8
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 a package is not found on this website although it may be
available in your favorite Linux distribution. Just let me know if you
are missing packages.
p
' The repositories that I am scanning frequently are:
ul
- @package_sources.each do |repo|
li
a href=repo[:url] =repo[:description]
.cell.large-4
h2 Who is using this site?
.cell.large-8
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 (2000x2000 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 itself with a nearly 100% availability over
the past decade.
.cell.large-4
h2 Can I see the source code of this web application?
.cell.large-8
p
' The source code is available to fellow Debian Developers 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
a href="https://rubyonrails.org/" Ruby-on-Rails
li
a href="https://shrinerb.com/" Shrine for file management
li
a href="https://www.postgresql.org/" PostgreSQL to store metadata
li
a href="https://get.foundation/" The Zurb Foundation web toolkit
li Icons from Font Awesome
li
a href="https://nginx.org/" Nginx as a caching reverse proxy
li
a href="https://www.debian.org/" Debian as an operating system to run everything on
li
a href="https://dokku.com/" Dokku to make the deployment painless
li
a href="https://photoswipe.com/" Photoswipe for the click-to-zoom on images