.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
