chaas/debshots
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions

Restyling

Browse source
This commit is contained in:
Christoph Haas 2018-06-27 18:43:08 +02:00
parent 9d6baa20e5
commit 06b8f92963
21 changed files with 492 additions and 493 deletions
Download patch file Download diff file Expand all files Collapse all files

413
app/views/welcome/about.slim
View file

@ -1,238 +1,235 @@
.row
h1 About this web site
h1 About this web site
p
|
This is a public repository of screenshots taken from applications contained
in the Debian GNU/Linux distribution and its derivates 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
h2 Who runs this site?
p
' This site is operated by Christoph Haas.
'
' Feel free to leave
a href="mailto:email@christoph-haas.de" feedback?
a name='cookies'
h2 Cookies and privacy
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 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 is a public repository of screenshots taken from applications contained
in the Debian GNU/Linux distribution and its derivates 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.
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
collected or processed. 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.
p
' This site is operated by Christoph Haas.
'
' Feel free to leave
a href="mailto:email@christoph-haas.de" feedback?
h2 Which software packages are listed?
a name='cookies'
h2 Cookies and privacy
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.
p
' I am very concerned with privacy myself. So this site stores as
' little information about your stay as possible. That is:
p
' The repositories that I am scanning frequently are:
ul
- @package_sources.each do |repo|
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
em
'Cookies.
|
Only if and when you upload a screenshot the website will send your
browser a 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.
// 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
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.
' http://screenshots.debian.net/package/PACKAGENAME
br
' (Page with details and screenshots for a certain package)
li
em
'Privacy.
|
Under no circumstance will information about your person be
collected or processed. I am happy to have you here as my guest.
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.
h2 Which software packages are listed?
' http://screenshots.debian.net/thumbnail/PACKAGENAME
br
' (Returns a thumbnail (160x120 pixels or less) of a package's first found
' 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
|
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.
' If you would like to get a complete list of packages or screenshots in JSON
' format then use one of these URLs:
p
' The repositories that I am scanning frequently are:
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.
ul
- @package_sources.each do |repo|
li
a href=repo[:url] =repo[:description]
h2 Uploading new screenshots
h2 Who is using this site?
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.
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 Why isn't this a debian.org service?
h2 How you can use the screenshots
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
' You can use the screenshots on your own website. Some useful URLs:
h2 Is this web application available as a Debian package?
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 a package's first found
' 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
|
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.
p
' If you would like to get a complete list of packages or screenshots in JSON
' format then use one of these URLs:
h2 Can I see the source code of this web application?
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.
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. :)
h2 Uploading new screenshots
h2 Statistics
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.
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.
h2 Why isn't this a debian.org service?
/ p
/ // TODO: Use plot about upload statistics
/ ' (Number of screenshots uploaded each month.)
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.
h2 Who is behind this site?
h2 Is this web application available as a Debian package?
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:
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 Can I see the source code of this web application?
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. :)
h2 Statistics
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.)
h2 Who is behind 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:
p
'Christoph Haas
br
'Oldesloer Straße 14a
br
'23843 Rümpel
br
'Email contact: email@christoph-haas.de
p
'Christoph Haas
br
'Oldesloer Straße 14a
br
'23843 Rümpel
br
'Email contact: email@christoph-haas.de

47
app/views/welcome/home.slim
View file

@ -1,9 +1,10 @@
#teaser.row
div.large-4.medium-4.small-3.columns
#teaser.grid-container
.grid-x
.large-4.medium-4.small-3.cell
#biglogo
// TODO: vary the logo depending on the virtual host
img src="/images/logos/debian.svg" width="400" alt="Debian logo"
div.large-8.medium-8.small-9.columns
img src="/images/logos/debian.svg" width="300" alt="Debian logo"
.large-8.medium-8.small-9.cell
h1 We have screenshots!
p
' Have you ever wondered how a certain piece of software looks
@ -14,18 +15,19 @@
' software packages coming with
' Debian and other Linux distributions. And of course you are encouraged to upload
' your own screenshots for others to explore.
p
= form_tag(packages_grid_path, method: 'GET')
div.row.collapse.postfix-round
div.small-9.columns
input type="text" name="search" placeholder="Looking for a special software?" autofocus="true"
div.small-3.columns
input.button.postfix type="submit" value="Search"
.input-group
input.input-group-field type="search" name="search" placeholder="Looking for a special software?" autofocus="true"
.input-group-button
input.button.postfix type="submit" value="Search"
div.row
div.large-4.medium-12.small-12.columns.text-center
.grid-container
.grid-x.align-spaced
.large-3.medium-12.small-12.cell.text-center
h2 Newest upload
div.thumb-height
.thumb-height
a href=package_path(@newest_upload.package.name)
= image_tag(@newest_upload.image.url(:thumb, timestamp: false), alt: @newest_upload.caption)
p
@ -33,9 +35,9 @@ div.row
=@newest_upload.package.name
' :
=@newest_upload.package.description
div.large-4.medium-12.small-12.columns.text-center
.large-3.medium-12.small-12.cell.text-center
h2 Most popular
div.thumb-height
.thumb-height
a href=package_path(@most_popular_package.name)
img src=@most_popular_package.screenshots.first.image.url(:thumb, timestamp: false)
p
@ -43,14 +45,15 @@ div.row
=@most_popular_package.name
' :
=@most_popular_package.description
div.large-4.medium-12.small-12.columns.text-center
h2 Your help needed
div.thumb-height
.large-3.medium-12.small-12.cell.text-center
h2 Contribute
.thumb-height
a href=upload_path(@most_wanted_package.name)
img src="/images/dummy/no-screenshots-upload-one.svg" width="160"
p
' We lack a screenshot for the
strong =>@most_wanted_package.name
' package. Can you
a href=package_path(@most_wanted_package.name) provide one
p
/ TODO: Randomly choose one of ~30 packages
' We lack a screenshot for the
strong =>@most_wanted_package.name
' package. Can you
a href=package_path(@most_wanted_package.name) provide one
' ?