docs: flake inputs

Author: ryan4yin

docs/en/other-usage-of-flakes/inputs.md

@@ -3,6 +3,8 @@
 The `inputs` section in `flake.nix` is an attribute set used to specify the dependencies
 of the current flake. There are various types of inputs, as shown in the examples below:
 
+> See Offical docs for details - [Flakes Inputs - Nix Manual].
+
 ```nix
 {
   inputs = {
@@ -18,8 +20,10 @@ of the current flake. There are various types of inputs, as shown in the example
     # Git URL with submodules, applicable to any Git repository using the https/ssh protocol.
     git-example-submodule.url = "git+https://git.somehost.tld/user/path?submodules=1";
     # Archive File URL, needed in case your input use LFS.
-    # Regular git input doesn't support LFS yet.
+    # Regular git input doesn't support LFS before nix 2.27
     git-example-lfs.url = "https://codeberg.org/solver-orgz/treedome/archive/master.tar.gz";
+    # Starting from nix 2.27, you can use the url like below to enable git lfs on flake input
+    treedome.url = "git+https://codeberg.org/solver-orgz/treedome?ref=master&lfs=1";
     # Similar to fetching a Git repository, but using the ssh protocol
     # with key authentication. Also uses the shallow=1 parameter
     # to avoid copying the .git directory.
@@ -62,3 +66,9 @@ of the current flake. There are various types of inputs, as shown in the example
   outputs = { self, ... }@inputs: { ... };
 }
 ```
+
+## 参考
+
+- [Flakes Inputs - Nix Manual]
+
+[Flakes Inputs - Nix Manual]: https://nixos.org/manual/nix/stable/command-ref/new-cli/nix3-flake.html#flake-references

docs/zh/other-usage-of-flakes/inputs.md

@@ -3,18 +3,28 @@
 `flake.nix` 中的 `inputs` 是一个 attribute set，用来指定当前 Flake 的依赖，inputs 有很多种
 类型，举例如下：
 
+> 详细的例子参见官方文档 [Flakes Inputs - Nix Manual]
+
 ```nix
 {
   inputs = {
     # 以 GitHub 仓库为数据源，指定使用 master 分支，这是最常见的 input 格式
     nixpkgs.url = "github:Mic92/nixpkgs/master";
     # Git URL，可用于任何基于 https/ssh 协议的 Git 仓库
     git-example.url = "git+https://git.somehost.tld/user/path?ref=branch";
-    # 同样是拉取 Git 仓库，但使用 ssh 协议 + 密钥认证，同时使用了 shallow=1 参数避免复制 .git
-    ssh-git-example.url = "git+ssh://[email protected]/ryan4yin/nix-secrets.git?shallow=1";
+    # Git URL by tag, applicable to any Git repository using the https/ssh protocol.
+    git-example-tag.url = "git+https://git.somehost.tld/user/path?tag=x.y.x";
+    # Github URL by pull request.
+    git-pr.url = "github:NixOS/nixpkgs?ref=pull/349351/head";
+    # Git URL with submodules, applicable to any Git repository using the https/ssh protocol.
+    git-example-submodule.url = "git+https://git.somehost.tld/user/path?submodules=1";
     # Archive File URL, needed in case your input use LFS.
-    # Regular git input doesn't support LFS yet.
+    # Regular git input doesn't support LFS before nix 2.27
     git-example-lfs.url = "https://codeberg.org/solver-orgz/treedome/archive/master.tar.gz";
+    # Starting from nix 2.27, you can use the url like below to enable git lfs on flake input
+    treedome.url = "git+https://codeberg.org/solver-orgz/treedome?ref=master&lfs=1";
+    # 同样是拉取 Git 仓库，但使用 ssh 协议 + 密钥认证，同时使用了 shallow=1 参数避免复制 .git
+    ssh-git-example.url = "git+ssh://[email protected]/ryan4yin/nix-secrets.git?shallow=1";
     # 当然也可以直接依赖本地的 git 仓库
     git-directory-example.url = "git+file:/path/to/repo?shallow=1";
     # 使用 `dir` 参数指定某个子目录
@@ -50,3 +60,10 @@
   outputs = { self, ... }@inputs: { ... };
 }
 ```
+
+
+## 参考
+
+- [Flakes Inputs - Nix Manual]
+
+[Flakes Inputs - Nix Manual]: https://nixos.org/manual/nix/stable/command-ref/new-cli/nix3-flake.html#flake-references