Valentin Gagarin
558ec3b67e
clarify what expressions and values are
2022-10-04 08:34:30 +02:00
Valentin Gagarin
8e332a4a4e
clarify scope
2022-10-04 08:34:30 +02:00
Valentin Gagarin
637cef7e10
add learning goals and prerequisites
2022-10-04 08:34:30 +02:00
Valentin Gagarin
397ed9f7d9
add instructions to run examples
2022-10-04 08:34:30 +02:00
Valentin Gagarin
95f364d714
reorder language properties, add dynamic typing
2022-10-04 08:34:30 +02:00
Valentin Gagarin
670c8e2d80
add alternative to @ syntax
2022-10-04 08:34:30 +02:00
Valentin Gagarin
50a21f1fbc
do not claim rec
is not suitable for static analysis
2022-10-04 08:34:30 +02:00
Valentin Gagarin
00f1366b7b
fix typo
2022-10-04 08:34:30 +02:00
Valentin Gagarin
884b7858be
draft: nix language tutorial
...
based on @tazjin's tazjin/nix-1p [1] and @zimbatm's NixCon 2019 talk "Reading The Nix Language" [2]
[1]: https://github.com/tazjin/nix-1p
[2]: https://youtu.be/hbJkMl631FE?t=1572
2022-10-04 08:34:30 +02:00
Domen Kožar
22ae50fb76
Merge pull request #326 from worktheclock/patch-9
...
Building and running Docker images RITZA edit
2022-09-26 13:38:51 +02:00
Domen Kožar
9dac52e1f1
Merge pull request #327 from worktheclock/patch-10
...
Cross compilation RITZA edit
2022-09-26 13:38:25 +02:00
worktheclock
0bdb1b2b50
Install Nix RITZA edit
2022-09-26 13:19:18 +02:00
worktheclock
fe84721779
Cross compilation RITZA edit
2022-09-26 13:13:01 +02:00
worktheclock
4c4ca4ceb5
Building and running Docker images RITZA edit
2022-09-26 11:06:56 +02:00
Robin Stumm
945e20d0c7
fix git version in example
...
broken in 5e0ba5f66b
2022-09-02 10:51:59 +02:00
Valentin Gagarin
a91c3e3c8c
update installation instructions
...
Darwin no longer needs special incantations
2022-09-01 19:09:22 +02:00
Valentin Gagarin
e475697073
fix typo
2022-08-28 14:28:10 +02:00
Valentin Gagarin
42e5ab74a5
rework notes on search paths
...
remove duplication so we can link to the respective section from the
language tutorial
2022-08-01 11:54:55 +02:00
worktheclock
99abfff9df
Build a bootable ISO image RITZA language edit
...
Language edit done by RITZA.
2022-07-21 12:00:26 +02:00
Domen Kožar
b7fa967792
Merge pull request #258 from worktheclock/patch-7
...
Ad hoc developer environments RITZA language edit
2022-07-12 11:52:54 -05:00
Domen Kožar
2bad219af5
fix a link
2022-06-27 10:39:57 -05:00
Domen Kožar
e59cbb3638
fix build
2022-06-27 10:35:35 -05:00
worktheclock
fef2f37846
Ad hoc developer environments RITZA language edit
2022-06-20 13:07:31 +02:00
Max Kalashnikoff
808de6c0fb
Fixing ./result/bin/myapp.py -> ./result/bin/myapp
...
After the `nix-build` command the result app bin is `myapp` and not `myapp.py`.
2022-05-02 14:18:21 +05:30
worktheclock
5a62ec9c1b
NixOS on Raspberry Pi RITZA language edit
2022-04-11 14:52:24 +02:00
Nejc Zupan
02ced7bbff
Proof-of-Concept for testing code samples
...
There are a number of code samples throughout nix.dev. How do we know
they still work? We don't!
This commit introduces a way for us to extract these code samples into files
and then run tests against them in CI. This will hopefully help us catch
regressions in future updates to nix, NixOS and/or this guide.
Additionally, I included a darwin specific nix-shell configuration that I
use personally on my M1 Mac to work on this repo. Might be useful for someone.
2022-04-07 10:16:17 +01:00
Domen Kožar
68416183e3
Merge pull request #241 from Michael-J-Ward/patch-2
...
Add note on multi-line shebang
2022-03-30 10:10:18 +01:00
Michael-J-Ward
da980645ab
Update source/tutorials/ad-hoc-developer-environments.md
...
per @domenkozar's suggestion
Co-authored-by: Domen Kožar <domen@enlambda.com>
2022-03-29 09:49:55 -04:00
Domen Kožar
69070ee4a8
Merge branch 'master' into patch-4
2022-03-29 10:28:38 +01:00
Domen Kožar
5e0ba5f66b
bump pins in ad-hoc tutorial
2022-03-29 10:22:29 +01:00
Britton Robitzsch
5221472a57
Update formatting issues for niv show and niv modify
...
Two commands were formatted as quotes instead of code. This caused an issue where --branch was formatted with '–' instead of '--'. This caused an error when copying and pasting the command into a terminal:
```
[nix-shell:~/niv]$ niv modify nixpkgs –branch nixos-21.05
Invalid argument `–branch'
Usage: niv [-s|--sources-file FILE] [--no-colors] COMMAND
```
2022-03-21 16:39:57 -06:00
Michael-J-Ward
b0b9be629c
Add note on multi-line shebang
...
The multi
2022-03-16 00:42:05 -04:00
worktheclock
67e9357985
Pinning Nixpkgs RITZA proofread
2022-03-14 13:26:25 +02:00
worktheclock
e659bece62
Set up dev env RITZA language edit
2022-01-27 08:43:01 +02:00
Valentin Gagarin
dbd0b8cfc4
more detail on specifying host platform
...
- explain mechanism of combining build and host platform in `nixpkgs` configuration
- add examples how to specify host platform in different ways
2021-12-15 12:03:44 +01:00
Valentin Gagarin
671e1d464d
clarify platform attr vs. config string
2021-12-15 12:03:44 +01:00
Valentin Gagarin
12004ac36f
add note on historicity platform encoding
...
there have been discussions around migrating the platform description to a more structured representation like an attribute set (cannot find relevant issue for reference right now), and it is worth noting that this string encoding is fairly arbitrary.
2021-12-15 12:03:44 +01:00
Valentin Gagarin
c3fe9d754c
reword distinction of target and host
...
use shorter sentences, emphasize keywords
2021-12-15 12:03:44 +01:00
Valentin Gagarin
dd2b939f89
reword note on Nix community
...
make clear `nixpkgs` is the package collection, which is not the same as `nix` the package manager or the broader Nix community
2021-12-15 10:37:01 +01:00
Nejc Zupan
e5e8253278
Convert the remaining tutorials from .rst to .md
2021-12-10 14:53:53 +00:00
Nejc Zupan
205e31841c
Convert cross-compilation.rst
...
Note that the footnotes are now really in the foot of the document,
not at the foot of the paragraph.
2021-12-10 14:38:32 +00:00
Nejc Zupan
6d066825ec
Converting moar tutorials
2021-12-10 14:34:01 +00:00
Nejc Zupan
38ca026b8f
Start converting tutorials from .rst to .md
2021-12-10 14:10:26 +00:00
Domen Kožar
04a0d31506
bump install-nix-action
2021-12-09 12:46:23 +01:00
nikstur
2d8e7b2c6d
Fixed image name in dd command
2021-12-09 04:11:15 +01:00
Nejc Zupan
ca2f7b4a95
fix a bunch more links
2021-12-06 16:48:55 +00:00
Nejc Zupan
8633fe329f
fix install links, and typos
2021-12-06 16:48:55 +00:00
Domen Kožar
c05d7c786b
Merge pull request #204 from urbas/aarch64-hydra-job
...
new hydra link to the aarch64 sd image
2021-12-04 15:06:12 +00:00
Matej Urbas
d4a8e02b75
new hydra link to the aarch64 sd image
2021-12-04 13:14:58 +00:00
Walfie
d7329e7032
Fix typos
2021-12-03 16:38:15 -05:00
Domen Kožar
bf6a0b5caf
bump install-nix-action
2021-11-12 15:09:25 -06:00
Domen Kožar
86206f316c
nix-install-action@v14.1
2021-11-03 06:04:49 -06:00
Eli Flanagan
32ce1e7b41
remove needless code fence
...
These came through raw on the webpage
2021-10-25 10:14:16 -04:00
Domen Kožar
3b5d6302f2
fix #187
2021-10-19 16:35:11 -05:00
Domen Kožar
8474297cea
Merge pull request #189 from ritza-co/GitHub-actions-proofread
...
Update continuous-integration-github-actions.rst
2021-10-19 16:30:55 -05:00
worktheclock
f16f7b22e2
Update continuous-integration-github-actions.rst
2021-10-18 11:46:37 +02:00
Domen Kožar
6b95160fe9
iso: fix NIX_PATH propagation
...
4 years old bug https://github.com/NixOS/nix/issues/1294
2021-10-04 16:32:29 -05:00
Samuel Gräfenstein
154bebe2e8
fix typos
2021-10-03 21:01:57 +02:00
Jörg Thalheim
9ca2a9a3f6
add short hacking tutorial for nixpkgs with docker
...
This example is intentionally a bit more verbose as docker might be used
by upstream authors to test package in nixpkgs without having to install
nix.
2021-09-30 09:12:31 +02:00
Domen Kožar
46e07de7aa
installation: split by OS
2021-08-19 15:20:38 +02:00
Domen Kožar
77dd9ef3cc
typo
2021-08-19 10:03:27 +02:00
Alex Jackson
5046487ded
fix broken link in raspberry pi tutorial
2021-08-18 08:38:31 -05:00
Domen Kožar
f91886ce27
add meta descriptions
2021-08-11 10:45:46 +02:00
Domen Kožar
2bc822cfe2
Typo
2021-08-06 22:09:13 +02:00
Domen Kožar
126ad72eed
docker images: mention macOS support and refresh next steps
2021-08-05 13:28:24 +02:00
Domen Kožar
601e79bcb4
building iso: changes based on feedback
2021-08-05 11:50:19 +02:00
Domen Kožar
705c71f3a2
Merge pull request #171 from nix-dot-dev/building-image
...
tutorial: building bootable ISO image
2021-08-02 14:53:00 +02:00
Domen Kožar
7db7db49ed
tutorial: building bootable ISO image
2021-08-02 14:48:42 +02:00
Domen Kožar
458f1bfdf2
Update source/tutorials/install-nix.rst
2021-07-22 10:05:11 +02:00
Tom Bereknyei
c2d98ff2b1
Add docker install
2021-07-21 16:23:57 -04:00
Domen Kožar
4e0b44622f
Merge pull request #166 from nix-dot-dev/rpi-firmware
...
rpi: suggest updating firmware in case image doesn't boot
2021-07-07 14:19:35 +02:00
Domen Kožar
a40c10277f
rpi: suggest updating firmware in case image doesn't boot
2021-07-07 13:54:04 +02:00
sterni
d087303b04
cross-compilation: fix platform terminology in shell example
...
* `nativeBuildInputs` is roughly equivalent to taking a package from `buildPackages` which
means that *its* host platform is the build platform of the derivation (so we can execute it during
the build) and its target platform is the host platform of the derivation (so e. g. compilers produce
binaries that can be executed where we want them to)
* `buildInputs` are needed on the *host* platform of the derivation
* What would the target platform be in this case? It would only be relevant if we were to build a
cross-compiler: Then we'd need runtime libraries for the target platform, for example.
2021-06-24 13:21:06 +02:00
Domen Kožar
eb36297f5c
index: link to cross compilation tutorial
2021-06-18 11:45:15 +02:00
Domen Kožar
ec9298d348
Merge pull request #160 from nix-dot-dev/cross-compilation-tutorial
...
Tutorial for cross-compilation
2021-06-17 15:01:50 +02:00
Domen Kožar
608df83a50
feedback
2021-06-17 11:01:07 +02:00
Domen Kožar
3729167720
Update source/tutorials/cross-compilation.rst
...
Co-authored-by: John Ericson <git@JohnEricson.me>
2021-06-16 15:36:13 +02:00
Domen Kožar
7b7c8360ff
Merge branch 'master' into cross-compilation-tutorial
2021-06-16 09:32:16 +02:00
Domen Kožar
44156f8bcc
Going forward -> Next steps
2021-06-15 16:58:33 +02:00
Domen Kožar
bee6cd582d
map benefits to tutorials
2021-06-15 16:56:41 +02:00
Domen Kožar
9d4e7e6362
Merge branch 'cross-compilation-tutorial' into patch-2
2021-06-15 16:47:42 +02:00
Domen Kožar
4604ab5e58
feedback
2021-06-15 15:53:10 +02:00
Kim R2
df7523b23e
Language edit
2021-06-15 15:41:39 +02:00
Domen Kožar
a928ff1dd3
feedback
2021-06-15 12:51:46 +02:00
Domen Kožar
365c3989b0
Tutorial for cross-compilation
2021-06-14 18:59:58 +02:00
Ilan Joselevich
24cc5d249c
Reverting terraform reference changes
...
Reverted due to Terraform's AWS image not being released for 21.05 yet.
2021-06-13 18:30:40 +03:00
Ilan Joselevich
9a554fd04f
replace all mentions of 20.03 and 20.09 with 21.05
2021-06-13 14:21:02 +03:00
Kim R2
eb55acc612
language edit
2021-06-07 13:08:36 +02:00
Domen Kožar
dedcd7b6b3
Add tutorial for integration testing using virtual machines
2021-06-03 22:23:01 +02:00
Domen Kožar
a3bef3e312
bump cachix-action in the tutorial
2021-05-14 19:57:50 +02:00
Domen Kožar
0937e7e02b
rpi4: review tweaks
2021-05-13 11:17:51 +02:00
Domen Kožar
160c9e6817
rpi4: clarify on root/user commands
2021-05-13 11:17:51 +02:00
Domen Kožar
51b7acb197
rpi4: add Going Forward section
2021-05-13 11:17:50 +02:00
Domen Kožar
800781beeb
RPi -> Raspberry Pi
2021-05-13 11:17:50 +02:00
Domen Kožar
96e7fef67e
rpi4: be explicit
2021-05-13 11:17:50 +02:00
Domen Kožar
a07ccb7e68
Apply suggestions from code review
...
Co-authored-by: Samuel Dionne-Riel <samuel@dionne-riel.com>
2021-05-13 11:17:50 +02:00
Domen Kožar
8f969f4595
Apply suggestions from code review
...
Co-authored-by: Nejc Zupan <nejc.zupan@gmail.com>
2021-05-13 11:17:50 +02:00
Domen Kožar
4b00f48479
Raspberry Pi tutorial
2021-05-13 11:17:48 +02:00
Gareth Dwyer
85e23ca44b
Update deploying-nixos-using-terraform.rst
2021-04-18 11:29:56 +02:00
Domen Kožar
8ffc25c13e
bump actions
2021-04-03 12:42:22 +02:00
Domen Kožar
d3bfaaab07
terraform: mention execution mode to be local
2021-03-10 16:02:45 +00:00
Domen Kožar
32effd4763
terraform: more typos
2021-03-10 15:10:48 +01:00
Domen Kožar
c932561487
terraform: typos
2021-03-10 15:05:31 +01:00
Robert Hensing
d20e1d5927
building-and-running-docker-images: Set system
...
This will help macOS users. While alternatives are possible[1]
this is the simplest solution.
1: https://github.com/NixOS/nixpkgs/pull/115083
2021-03-04 19:26:12 +01:00
Ryan Mulligan
48de544f9c
fix grammar on install nix
2020-12-09 20:56:18 -08:00
Domen Kožar
7fa11091c5
contribuing: remove bogus sentence
2020-11-23 15:47:37 +01:00
Domen Kožar
cc28a13cc7
fix linkcheck
2020-11-18 18:42:27 +01:00
Domen Kožar
03116cfee0
fix redirect
2020-11-18 18:38:24 +01:00
Domen Kožar
1108d0bde0
Add tutorial for deploying NixOS with Terraform
2020-11-18 18:38:24 +01:00
Domen Kožar
8db1b57c39
github actions: follow up with cachix API write tokens
2020-11-10 15:14:44 +01:00
Domen Kožar
38962b0e57
bump actions
2020-11-05 18:10:52 +01:00
Sylvain Bellemare
50000ce382
Remove semi-colon from fetchTarball example
2020-10-01 23:34:53 +01:00
Domen Kožar
8728dcf44d
github actions: install-nix-action v11
2020-09-21 16:01:16 +02:00
Domen Kožar
9aa910fd8b
Merge branch 'master' into patch-1
2020-07-14 15:40:38 +02:00
Domen Kožar
9c729e7d28
Update source/tutorials/towards-reproducibility-pinning-nixpkgs.rst
2020-07-13 16:10:02 +02:00
Domen Kožar
5b73996367
pinning: be more precise about filenames
2020-07-13 10:19:32 +02:00
Bryan Richter
f89414ee00
Formulate niv example for use in default.nix
...
I assume most people will try to use this in a top-level default.nix, as I did. :)
2020-07-10 22:53:33 +03:00
Arian van Putten
2837ed935f
Update towards-reproducibility-pinning-nixpkgs.rst
2020-07-09 20:09:47 +02:00
Gareth Dwyer
0bd8a0b02f
re-add header
2020-07-09 12:13:04 +02:00
Gareth Dwyer
992b8f9968
reproducibile shell edits
2020-07-09 12:09:24 +02:00
Domen Kožar
a213c370f5
fix #25 : link getting started Nix template
2020-07-08 14:09:32 +02:00
Domen Kožar
cbf8cddc4e
typo
2020-07-07 16:58:18 +02:00
Domen Kožar
030805f226
Merge pull request #75 from nix-dot-dev/github-actions
...
Continuous Integration with GitHub Actions
2020-07-07 13:29:29 +02:00
Domen Kožar
4fcc556e3f
Update source/tutorials/continuous-integration-github-actions.rst
...
Co-authored-by: zimbatm <zimbatm@zimbatm.com>
2020-07-07 11:27:40 +02:00
Domen Kožar
ebff7b7a20
direnv: make setup a heading
2020-07-07 10:49:02 +02:00
Domen Kožar
65508e2023
feedback
2020-07-07 10:26:09 +02:00
Domen Kožar
bb55fbf8ad
Continuous Integration with GitHub Actions
2020-07-06 17:31:01 +02:00
Domen Kožar
f2d8df94a8
typo
2020-07-06 10:09:50 +02:00
Lucas Desgouilles
82da1852e7
Fix typo in source/tutorials/contributing.rst
2020-07-05 16:29:02 +02:00
Eduard Bopp
168e67a6b5
Fix errors in dev environment tutorial
2020-07-01 18:19:00 +02:00
Domen Kožar
0a2de10756
review
2020-07-01 15:54:41 +02:00
Domen Kožar
3885db3e94
rewrite tutorial on declarative environments
2020-06-30 14:50:02 +02:00
Damien Cassou
561ac903a1
Quote URLs in Nix expressions
...
Unquoted URLs are an anti-pattern that we recommend against.
2020-06-28 20:18:55 +02:00
Domen Kožar
89d0c7d21c
Merge pull request #63 from sixhobbits/master
...
docker edits
2020-06-28 17:36:23 +02:00
Gareth Dwyer
ce4da9f735
docker edits
2020-06-28 10:45:38 +02:00
Damien Cassou
3fd18b38ca
Small fix
2020-06-25 11:49:16 +02:00
Domen Kožar
cc1e46b9e2
Update source/tutorials/building-and-running-docker-images.rst
2020-06-23 17:23:50 +02:00
Domen Kožar
4ba3c3f5a2
Apply suggestions from code review
2020-06-23 17:23:50 +02:00
Domen Kožar
7c69a4e50d
Update source/tutorials/building-and-running-docker-images.rst
2020-06-23 17:23:50 +02:00
Domen Kožar
9b455de5ec
Update source/tutorials/building-and-running-docker-images.rst
2020-06-23 17:23:50 +02:00
Eduard Bopp
479f8f8570
Link to nixpkgs manual
2020-06-23 17:23:50 +02:00
Eduard Bopp
2e7eb8dbdc
Apply suggestions from code review
...
Co-authored-by: Domen Kožar <domen@enlambda.com>
2020-06-23 17:23:49 +02:00
Eduard Bopp
94a8a7e794
Write tutorial about Docker images
2020-06-23 17:23:49 +02:00
Eduard Bopp
b57a05066e
Remove trailing whitespace from rst files
2020-06-21 14:26:51 +02:00
Gareth Dwyer
3482b93ded
Merge remote-tracking branch 'origin/add-edits-towards-reproducibility'
2020-06-19 17:32:16 +02:00
Gareth Dwyer
9606ab9e82
edits for towards repro tutorial
2020-06-19 17:30:46 +02:00
Domen Kožar
df649e8020
install Nix: 2.3.6
2020-06-18 10:36:42 +02:00
Domen Kožar
03f8d1b07a
ad-hoc-environment: show the correct ouput
2020-06-15 17:03:45 +02:00
Gareth Dwyer
96302feb9b
Update source/tutorials/ad-hoc-developer-environments.rst
...
Co-authored-by: Domen Kožar <domen@enlambda.com>
2020-06-14 17:12:44 +02:00
Gareth Dwyer
7393a40727
tutorial edits
2020-06-14 17:12:44 +02:00
Domen Kožar
8abe2ee0e9
pinning nixpkgs: link from tutorial to reference
2020-06-11 16:15:35 +02:00
Domen Kožar
61ad01c8cf
unmess
2020-06-09 14:00:55 +02:00
Domen Kožar
1b7d60fd21
pinning: instruct how to update dependencies
2020-06-09 13:54:54 +02:00
Domen Kožar
4d524ebd62
rename
2020-06-09 13:53:22 +02:00
Domen Kožar
d169ddd76c
add ref from ad-hoc tutorial to pinning nixpkgs
2020-06-09 13:53:00 +02:00
Domen Kožar
927dc9b102
Update source/tutorials/towards-reproducability-pinning-nixpkgs.rst
...
Co-authored-by: zimbatm <zimbatm@zimbatm.com>
2020-06-09 13:49:45 +02:00
Domen Kožar
26c06b93f7
Update source/tutorials/index.rst
...
Co-authored-by: zimbatm <zimbatm@zimbatm.com>
2020-06-09 13:49:37 +02:00
Domen Kožar
1deadc8db1
Update source/tutorials/towards-reproducability-pinning-nixpkgs.rst
...
Co-authored-by: zimbatm <zimbatm@zimbatm.com>
2020-06-09 13:48:43 +02:00
Domen Kožar
6f96c995b4
Update source/tutorials/towards-reproducability-pinning-nixpkgs.rst
...
Co-authored-by: zimbatm <zimbatm@zimbatm.com>
2020-06-09 13:48:30 +02:00
Domen Kožar
54b352f050
Tutorial on pinning nixpkgs
2020-06-09 11:14:51 +02:00
Domen Kožar
c07c26fe7a
install-nix: skip Catalina workaround now that Nix 2.3.5 is out
2020-06-05 13:52:09 +02:00
Domen Kožar
04dcbdf84d
rename first-shell
2020-05-22 10:17:14 +02:00
Domen Kožar
5170bfe38c
Merge pull request #18 from domenkozar/ad-hoc-developer-environments
...
Tutorial: ad hoc developer environments
2020-05-22 10:04:55 +02:00
Domen Kožar
b19d35a8f0
ad hoc developer environments: review feedback
2020-05-21 09:54:24 +02:00
Domen Kožar
1a6d843836
Tutorial: ad hoc developer environments
2020-05-20 17:16:30 +02:00
Domen Kožar
27b14d728b
Nix installation tutorial
2020-05-19 12:34:39 +02:00
Domen Kožar
e55008fdb6
fix build
2020-05-18 11:41:12 +02:00
Domen Kožar
113e86bf52
add live reloading
2020-05-18 11:40:46 +02:00
Domen Kožar
cac8b24e67
add tutorials
2020-05-18 10:52:41 +02:00
Domen Kožar
e6a3e3d38a
garden
2020-05-18 10:41:38 +02:00
Domen Kožar
1649643c77
Add more FAQ entries
2016-12-06 11:45:47 +01:00
Domen Kožar
7c4daba3ad
initial commit
2016-05-04 11:30:29 +01:00