docs: add doc for miniforge (#108)

Author: determ1ne

docs/zh/miniforge.mdx

@@ -0,0 +1,41 @@
+---
+mirrorId: miniforge
+---
+import  { Miniforge3Installer, CondaConfigGen } from '../../src/components/anaconda-config';
+
+Miniforge 类似 Anaconda/Miniconda ，但以 conda-forge 为主要 channel ，使用 conda 和 mamba 管理软件包。
+
+### 安装包下载
+
+<Miniforge3Installer />
+
+
+### 设置软件包镜像
+
+修改用户目录下的 `.condarc` 文件来使用浙大镜像源。
+
+Windows 用户无法直接创建名为 `.condarc` 的文件，可先执行 `conda config --set show_channel_urls yes` 生成该文件之后再修改。
+
+1. 根据需要修改 `.condarc` 配置如下：
+
+<hr />
+
+<CondaConfigGen isMiniforge3 />
+
+<hr />
+
+2. 运行 `conda clean -i` 清除索引缓存，保证用的是镜像站提供的索引。
+
+3. 运行 `conda create -n myenv numpy` 测试一下吧。
+
+### 反代 channel 说明
+
+为解决校内访问问题，以下 channel 通过反代方式提供服务：
+
+- nvidia
+
+这些 channel 在校外访问时，会通过 302 请求重定向至官方源。
+
+### 其他第三方源
+
+暂不支持。

src/components/anaconda-config.tsx

@@ -25,7 +25,6 @@ const osNameDict: Record<string, string> = {
   MacOSX: 'macOS',
   Linux: 'Linux',
 };
-
 const installerDict: Record<string, HumanReadableInstallerName> = {
   '': {},
   'Windows': {
@@ -49,6 +48,28 @@ const installerDict: Record<string, HumanReadableInstallerName> = {
   },
 };
 
+const mf3Prefix = 'https://mirrors.zju.edu.cn/miniforge/';
+const mf3OsNameDict: Record<string, string> = {
+  Windows: 'Windows',
+  Darwin: 'macOS',
+  Linux: 'Linux',
+};
+const mf3InstallerDict: Record<string, HumanReadableInstallerName> = {
+  '': {},
+  'Windows': {
+    'x86_64.exe': 'x86_64 EXE',
+  },
+  'Darwin': {
+    'arm64.sh': 'ARM64 SH (Apple Silicon)',
+    'x86_64.sh': 'x86_64 SH (Intel)',
+  },
+  'Linux': {
+    'x86_64.sh': 'x86_64 SH',
+    'aarch64.sh': 'arm64 SH',
+    'ppc64le.sh': 'ppc64le SH',
+  },
+};
+
 const MinicondaInstaller = () => {
   const [os, setOS] = useState('');
   const [variant, setVariant] = useState('');
@@ -116,6 +137,72 @@ const MinicondaInstaller = () => {
   );
 };
 
+const Miniforge3Installer = () => {
+  const [os, setOS] = useState('');
+  const [variant, setVariant] = useState('');
+  const installerName = os && variant ? `Miniforge3-${os}-${variant}` : '';
+
+  const handleOSChange: SelectProps['onChange'] = event => {
+    setOS(event.target.value as string);
+    setVariant('');
+  };
+
+  const handleVariantChange: SelectProps['onChange'] = event => {
+    setVariant(event.target.value as string);
+  };
+
+  return (
+    <div>
+      <FormControl variant="standard" sx={{ m: 1, minWidth: 120 }}>
+        <InputLabel id="os-select-label">操作系统</InputLabel>
+        <Select
+          labelId="os-select-label"
+          id="os-select"
+          value={os}
+          onChange={handleOSChange}
+          label="操作系统"
+        >
+          {Object.keys(mf3OsNameDict).map(osKey => (
+            <MenuItem value={osKey} key={osKey}>
+              {mf3OsNameDict[osKey]}
+            </MenuItem>
+          ))}
+        </Select>
+      </FormControl>
+      <FormControl variant="standard" sx={{ m: 1, minWidth: 300 }}>
+        <InputLabel id="variant-select-label">
+          系统架构 及 安装包类型
+        </InputLabel>
+        <Select
+          labelId="variant-select-label"
+          id="variant-select"
+          value={variant}
+          onChange={handleVariantChange}
+          label="系统架构及安装包类型"
+        >
+          {Object.keys(mf3InstallerDict[os]).map(k => (
+            <MenuItem value={k} key={`${os}-${k}`}>
+              {mf3InstallerDict[os][k]}
+            </MenuItem>
+          ))}
+        </Select>
+      </FormControl>
+      <br />
+      <Button
+        variant="contained"
+        startIcon={<DownloadIcon />}
+        sx={{ m: 1 }}
+        disabled={!installerName}
+        href={mf3Prefix + installerName}
+      >
+        <Typography textTransform="none">
+          下载 {installerName && `(${installerName})`}
+        </Typography>
+      </Button>
+    </div>
+  );
+};
+
 const baseConf = `channels:
   - defaults
 show_channel_urls: true
@@ -207,7 +294,9 @@ const channelOriginToUrl = (origin: ChannelOrigin) => {
   return 'https://mirrors.zju.edu.cn/anaconda-r';
 };
 
-const CondaConfigGen = () => {
+const CondaConfigGen: React.FC<{
+  isMiniforge3?: boolean;
+}> = ({ isMiniforge3 }) => {
   const [showCustom, setShowCustom] = useState(false);
   const [channelStatus, setChannelStatus] = useState(defaultChannelStatus);
 
@@ -221,7 +310,7 @@ const CondaConfigGen = () => {
     });
   };
 
-  let conf = baseConf;
+  let conf = isMiniforge3 ? '' : baseConf;
   if (Object.values(channelStatus).some(v => v)) {
     conf += 'custom_channels:\n';
   }
@@ -243,18 +332,22 @@ const CondaConfigGen = () => {
       </FormGroup>
       <Collapse in={showCustom}>
         <FormGroup sx={{ flexDirection: 'row' }}>
-          <FormControlLabel
-            control={<Checkbox defaultChecked disabled />}
-            label="pkgs/main"
-          />
-          <FormControlLabel
-            control={<Checkbox defaultChecked disabled />}
-            label="pkgs/r"
-          />
-          <FormControlLabel
-            control={<Checkbox defaultChecked disabled />}
-            label="pkgs/msys2"
-          />
+          {!isMiniforge3 && (
+            <>
+              <FormControlLabel
+                control={<Checkbox defaultChecked disabled />}
+                label="pkgs/main"
+              />
+              <FormControlLabel
+                control={<Checkbox defaultChecked disabled />}
+                label="pkgs/r"
+              />
+              <FormControlLabel
+                control={<Checkbox defaultChecked disabled />}
+                label="pkgs/msys2"
+              />
+            </>
+          )}
           {Object.keys(channelStatus).map(channel => {
             return (
               <FormControlLabel
@@ -281,4 +374,4 @@ const CondaConfigGen = () => {
   );
 };
 
-export { MinicondaInstaller, CondaConfigGen };
+export { MinicondaInstaller, Miniforge3Installer, CondaConfigGen };