nixos / nixos-homepage Goto Github PK

I couldn't find the source file for this, so I figured I'd make a ticket.

On this page, the following is stated:

builtins.readDir path

Return the contents of the directory path as a set mapping directory entries to the corresponding file type. For instance, if directory A contains a regular file B and another directory C, then builtins.readDir ./A will return the set

{ A = "regular"; B = "directory"; }

... however, wouldn't this be { B = "regular"; C = "directory" }?

In [Python docs] if you see a section heading, you move your mouse pointer to it and link “¶” appears. If you press on it, your browser's address bar now contains full link to that section. Compare:

• https://docs.python.org/2/library/stdtypes.html
• https://docs.python.org/2/library/stdtypes.html#numeric-types-int-float-long-complex

Is it possible to create such convenience links in Nix and NixOS manuals? This would improve manual UX and make easier to link to specific portions of the manual.

For example, boot.initrd.network.enable:

    boot.initrd.network.enable = mkOption {
      type = types.bool;
      default = false;
      description = ''
        Add network connectivity support to initrd. The network may be
        configured using the <literal>ip</literal> kernel parameter,
        as described in <link
        xlink:href="https://www.kernel.org/doc/Documentation/filesystems/nfs/nfsroot.txt">the
        kernel documentation</link>.  Otherwise, if
        <option>networking.useDHCP</option> is enabled, an IP address
        is acquired using DHCP.
      '';
    };

is viewed like

Description:        Add network connectivity support to initrd. The network may be configured using the ip kernel parameter, as described in
Default value:      false
Example value:      Not given
Declared in:        nixos/modules/system/boot/initrd-network.nix

Splitting the documentation is nice, because we have all these source links, but this breaks the browser search. We should enable both a single HTML page and the multi-page documentation as well.

Having a website search box is not an option, as this implies spending extra time loading even more pages which might not have the result/context that might interest me.

More and more projects link to their packages on github/nixos/nixpkgs - it would be nice (in manner of user experience) to link to the package on nixos.org/nixos/packages. Currently this is not possible.

A simple solution would be to pass the search term via HTTP GET, I think. I would file the PR for this myself, though I'm by no means a JS guy, so I guess I'll struggle hard to accomplish this.

https://nixos.org/nixos/download.html

The graphical and minimal live cd ISOs links to NixOS 14.04 and not the latest stable 14.12 version

I considered installing Nix to test Stack's nix integration (commercialhaskell/stack#2537 (comment)) but was afraid it'd set up a different GHC and create potential configuration conflicts. Given my upcoming deadlines, it makes sense to be most conservative (I've used Gentoo as my main Linux distro time ago and customized lots of it, but these days I have another job to focus on).

It turns out it only installs nix- prefixed binaries, so there's no such risk, but the download page could tell me that.

More in general, I'd like to know what happens by installing Nix before I do decide to install it.

On the home page especially, for non-widescreen window sizes, the columns can get too narrow and cause irregular whitespacing and readability problems. While this does not fix it in Chrome because it's not supported, this would adequately address the issue for now:

p {
  -webkit-hyphens: auto;
  -moz-hyphens: auto;
  hyphens: auto;
}

DBIx::Class::Storage::DBI::catch {...} (): DBI Connection failed: DBI connect('dbname=hydra;user=hydra;','',...) failed: could not connect to server: No such file or directory
Is the server running locally and accepting
connections on Unix domain socket "/tmp/.s.PGSQL.5432"? at /nix/store/z3zxpa6b7wiaxs86117lmk7mr82xfp10-hydra-perl-deps/lib/perl5/site_perl/5.22.1/DBIx/Class/Storage/DBI.pm line 1489. at /nix/store/129hj3i7lafa1p3bm5v5vhvpda8wivkx-hydra-0.1.1234.abcdef/libexec/hydra/lib/Hydra/Helper/CatalystUtils.pm line 357

I think https://nixos.org/nixpkgs/ at least should state where the repository is?

Can I start translating website by myself ?

The link to the latest version of the manual on
http://nixos.org/nixpkgs/download.html
is broken.

The link http://hydra.nixos.org/job/nixpkgs/trunk/tarball/latest/download-by-type/doc/manual
should probably be replaced with
http://hydra.nixos.org/job/nixpkgs/trunk/manual/latest

At least the manual could mention that in an advanced section. But I'd prefer to know that in advance.

EDIT: I trust that removing /nix is enough to get a working system without Nix, but it's nice to know how to undo all the changes done by the installer.

Since we're having half-year releases, we should start having an option to select what version should the docs be.

Currently: unstable, 14.12, 14.04, 13.10

The heading is large and renders poorly at many sizes (that I consider reasonable on my laptop). Reducing the font size of same parts makes it somewhat better. I was just hacking around and changed the "The purely functional Linux distribution" to a <h2> and reduced the font size of the introduction 16px.

Related, the navbar collapses even when there is plenty of room to display everything (see the screenshots). Is it possible to change that?

I went to the options page and searched for users.extraUsers.<name?>.passwordFile, but clicking on it wouldn't expand the details. There was an error on line 276 of options.html, which tests v._type == "literalExample". When the option's default is null, v is null and that is an error.

Actually, I don't know if it only happens in default values, they were the only examples I could find (e.g all the password options in users.extraUsers).

In section 5.1 Prerequisites the link for the Boehm Garbage Collector

http://www.hpl.hp.com/personal/Hans_Boehm/gc/

is not working. Looking at Wikipedia the official site seems to be

http://www.hboehm.info/gc/

search for git-crypt on http://nixos.org/nixos/packages.html

Nix expression: pkgs/applications/version-management/git-and-tools/git-crypt/default.nix

but the link is https://github.com/NixOS/nixpkgs/blob/release-15.09/default.nix#L23

the file is actually at the path from nix expression.

https://nixos.org/nixos/packages.html

is: https://github.com/NixOS/nixpkgs/blob/release-14.12//nix/store/ia013c0gf5p4srg2h6c87az0a4j4m15g-nixos-15.09.338.b02bbbc/nixos/pkgs/games/0ad/default.nix#L116
should be: https://github.com/NixOS/nixpkgs/blob/release-15.09/pkgs/games/0ad/default.nix#L116

https://github.com/NixOS/nixos-homepage/blob/master/nixos/packages.tt#L172
@edolstra do you mean this issue with your FIXME comment? then i would delete it in my fix.

If you visit e.g. https://nixos.org/wiki/NixOS_on_Amazon_EC2 (or any other page) you'll get

Object not found!

The requested URL was not found on this server. If you entered the URL manually please check your spelling and try again.

If you think this is a server error, please contact the webmaster.

Error 404
nixos.org
Sun Apr 3 11:27:41 2016
Apache/2.2.31 (Unix) DAV/2 mod_ssl/2.2.31 OpenSSL/1.0.2g

Some options, like permitRootLogin, specify a number of valid options.

It'd probably be nice to show those valid options on the Options page as well, when expanding an entry. Including descriptions of each option would be even nicer, but as those are not currently defined in the .nix files, that might be out of scope for this issue.

Extra cool would be tabs allowing to search in different channels the way debian / ubuntu allow switching to a different distribution at the top [1].

[1]
http://packages.ubuntu.com/search?keywords=python-numpy

For the search packages, and search options pages, it would be great if search terms could be passed trough the url, like most search engines.
That way they could be used in scripts and as a FF search engine.
I use a bunch of scripts trough dmenu, that let me search the web and do other nifty things with the primary selection, for example:
https://github.com/StudioDotfiles/DotRepo/blob/master/i3/scripts/actions/google

I'd recommend Discourse. Some examples:

• http://discourse.wicg.io
• http://forums.meteor.com

"NixOS 15.09 released" news link to release notes is broken.

current link
http://nixos.org/nixos/manual/sec-release-15.09.html

correct link
http://nixos.org/nixos/manual/release-notes.html#sec-release-15.09

Not sure if this is the right place, but https://nixos.org/wiki/NixOS_on_Amazon_EC2 is out of date seemingly, specifically nixos-rebuild pull results in:

/run/current-system/sw/bin/nixos-rebuild: unknown option `pull'

I know it's a Wiki, I'd fix it if I knew enough yet to know what the right thing is now :) (looks like nixos-rebuild --upgrade switch might be it?)

(In an unrelated note which probably deserves to be elsewhere, all the tools [well the two there] seem to have --help but no -h. Is this intentional?)

Old links will not end up where they should.

It would be great if that url had a more technical description of nixos, perhaps by simply including part of the manual.

Here are some resources causing insecure content warnings in Chrome when visiting various pages on https://nixos.org:

• http://img2.wikia.nocookie.net/__cb20110509221950/cartoonnetwork/images/a/a2/Ir001.gif
• http://www.ohloh.net/p/25550/widgets/project_basic_stats.js
• http://farm1.static.flickr.com/185/367433201_9ee5ad0986_m.jpg
• http://www.icfpconference.org/icfp2008/icfplarge.gif
• http://www.google.com/search (this one is the site search)

It would be awesome if there were a distinct logo for Nix, NixOS etc.

Perhaps the mirrored lambda signs that make up the current logo could be used:

• nix is a single sign
• nixpkgs is three signs, like a forest
• nixos is the circle
• nixops is intertwined circles like the Olympic rings
• hydra is a circular tree of signs, like a plasma lightning disk

Hi,

wanted to search for some options, but if you click on for example

services.httpd.documentRoot
services.httpd.globalRedirect
boot.initrd.luks.devices.*.yubikey
containers.<name>.hostAddress

nothing shows up and you can see a javascript error in debugging console of your browser.

I cannot find an RSS or Atom feed for the http://nixos.org/news.html

I found a /news.xml page, but this is apparently a custom format.

If you build such a feed, can you also add an RSS icon link somewhere on the homepage?

Because Haskell are no longer visible to nix-env -qa, they don't show up in the package search page anymore either. Would be nice if we can make them show up. Basically this would require adding the result of nix-env -qaP -A haskellPackages to packages.json.

Search NixOS packages page fails with "Failed to get package data" alert.

https://github.com/NixOS/nixos-homepage/blob/master/nixos/packages.tt#L215

is failing on:

https://nixos.org/nixos/packages.html on both firefox and chrome.

Both links of the nixops 1.4 released news are broken:

• NixOps 1.4
• manual (#ssec-relnotes-1.4 anchor doen't exists)

cc @rbvermaa

checked the first 15 packages, always "License: Not specified" but it is in the Nix expression.

for example:

https://github.com/NixOS/nixpkgs/blob/release-15.09/pkgs/games/0ad/default.nix#L118
https://github.com/NixOS/nixpkgs/blob/release-15.09/pkgs/games/pong3d/default.nix#L20
https://github.com/NixOS/nixpkgs/blob/release-15.09/pkgs/applications/audio/aacgain/default.nix#L42

https://github.com/NixOS/nixos-homepage/blob/master/nixos/packages.tt#L194

source for data packages.json.gz:

"license":[  
            {  
               "fullName":"GNU General Public License v2.0 only",
               "shortName":"gpl2",
               "spdxId":"GPL-2.0",
               "url":"http://spdx.org/licenses/GPL-2.0"
            },
            {  
               "fullName":"GNU Library General Public License v2.1 only",
               "shortName":"lgpl21",
               "spdxId":"LGPL-2.1",
               "url":"http://spdx.org/licenses/LGPL-2.1"
            },
            {  
               "fullName":"MIT License",
               "shortName":"mit",
               "spdxId":"MIT",
               "url":"http://spdx.org/licenses/MIT"
            },
            {  
               "fullName":"Creative Commons Attribution Share Alike 3.0",
               "shortName":"cc-by-sa-30",
               "spdxId":"CC-BY-SA-3.0",
               "url":"http://spdx.org/licenses/CC-BY-SA-3.0"
            },
            {  
               "fullName":"zlib License",
               "shortName":"zlib",
               "spdxId":"Zlib",
               "url":"http://spdx.org/licenses/Zlib"
            }
         ],

output comma seperated list of spdxId.

Since dc30713 the install script fails on rhel with:

you do not have 'shasum' installed, which I need to verify the binary tarball

On rhel 7.2, shasum is not available (at least not directly) but there are sha512sum and cie.

Probably fairly easy to fix, but it looks a little awkward right now.

The NixOS logo on the wiki is not in scale (is vertically squashed). Its resolution is 135x135, but a regular hexagon would have ratio of about 0.87:1. The picture in question is in this repository (logo/nix-wiki.png).

why do i get this error message but the browser has loaded the file like the live site?

Select channel: Linux or Mac, stable or unstable

since unstable channels are very active, the packages.json.gz should get generated at least once a day from github source, better every hour.

When you click on Nix you get almost the same view as the home page.

Perhaps Nix needs a different logo, maybe the same one in gold or only a part so that it shows nixos is made from nix.

Both of the urls below return 404s:

http://releases.nixos.org/nixos/14.12/nixos-14.12.496.5f7d374/nixos-14.12.496.5f7d374-x86_64-linux.ova
http://releases.nixos.org/nixos/14.12/nixos-14.12.496.5f7d374/nixos-14.12.496.5f7d374-i686-linux.ova

On my phone I get the mobile view, and for nixos and nix that is simply two times the logo, no text.

Furthermore, the projects drop-down shows but doesn't allow clicking on a project.

Currently the wiki seems to be using base styles, and it has a different feel to it than the manual. Making the wiki have the same look as the manual (at least in terms of typography) would make the wiki more readable.

I did a little editing of the frontpage (changed text, removed the blogs, news, commit lists, to be put elsewhere. But as I'm trying to commit the changes to my github account I noticed that it tries to add the new file "nixpkgs-commit-stats.json".

Shouldn't that file be in .gitignore?

EDIT: Yes... it is inside .gitignore, and yet git wants to commit it. Is there something wrong with my logic today, perhaps?

On the nixos homepage, the widget displaying the newest nixpkgs commits somehow got stuck on oct-08. Clicking on "more" leads to the github page of current commits, showing that of course there are many commits every day, also after oct-08.

In the News section at NixOS 14.12 released
The link

http://nixos.org/nixos/manual/sec-release-14.12.html

invalid.

The only thing the wiki spits out is this:

Mailer returned: Unknown error in PHP's mail() function.

Someone that can look at the logs will be better suited to see what's the issue.

http://nixos.org/irc/logs/ doesn't have logs more recent than 03-Jan-2014 18:01