diff --git a/content/docs/BestPractices/begin-as-an-afterword/index.md b/content/docs/BestPractices/begin-as-an-afterword/index.md index 5e701453..5ad547bd 100644 --- a/content/docs/BestPractices/begin-as-an-afterword/index.md +++ b/content/docs/BestPractices/begin-as-an-afterword/index.md @@ -8,7 +8,7 @@ _Created by Microsoft, Described by waldo_ ## Description -When `begin` follows `then`, `else`, `do`, it should be on the same line, preceded by one space character. +When `begin` follows `then`, `else`, `do`, it should be on the same line, preceded by one space character. ## Bad code @@ -26,3 +26,4 @@ When `begin` follows `then`, `else`, `do`, it should be on the same line, preced ... end; ``` + diff --git a/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/EnvironmentVariables.png b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/EnvironmentVariables.png new file mode 100644 index 00000000..1f76acbe Binary files /dev/null and b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/EnvironmentVariables.png differ diff --git a/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/EnvironmentVariablesPath.png b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/EnvironmentVariablesPath.png new file mode 100644 index 00000000..7c4bb5f6 Binary files /dev/null and b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/EnvironmentVariablesPath.png differ diff --git a/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/Extract.png b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/Extract.png new file mode 100644 index 00000000..35cb5f98 Binary files /dev/null and b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/Extract.png differ diff --git a/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/ExtractToBin.png b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/ExtractToBin.png new file mode 100644 index 00000000..ba466115 Binary files /dev/null and b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/ExtractToBin.png differ diff --git a/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/HugoServe.png b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/HugoServe.png new file mode 100644 index 00000000..569b5098 Binary files /dev/null and b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/HugoServe.png differ diff --git a/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/SearchForEnv.png b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/SearchForEnv.png new file mode 100644 index 00000000..881136cd Binary files /dev/null and b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/SearchForEnv.png differ diff --git a/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/SelectExtended.png b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/SelectExtended.png new file mode 100644 index 00000000..a8adec9c Binary files /dev/null and b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/SelectExtended.png differ diff --git a/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/SystemProperties.png b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/SystemProperties.png new file mode 100644 index 00000000..ae8adee9 Binary files /dev/null and b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/SystemProperties.png differ diff --git a/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/index.md b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/index.md new file mode 100644 index 00000000..671484d5 --- /dev/null +++ b/content/docs/Contributing/InstallHugo/ManuallyOnWindows11/index.md @@ -0,0 +1,57 @@ +--- +title: "Manually on Windows 11" +--- + +This guide will walk You thrugh installing Hugo on a Windows 11 PC. For the official install guide, You can wisit . + +## Download Binaries + +The path of least resistance is to just download the .zip file from the official Hugo GitHub Repository [here](https://github.com/gohugoio/hugo/releases). + +The theme that are used, needs the extended version of Hugo, so make sure to download the **extended** version by ensuring the file name starts with `hugo_extended...` + +{{% alert title="info" color="info" %}} +For the purpose of this install guide, we are assuming You will want to follow the "standard" used by Hugo for installing. We will be creating a `Hugo` folder in the root of `C:\`. That folder will have a `Bin` folder for the binaries, and a `Sites` folder for each website You are building. + +Once You are done, You should have a folder structure that looks like this: + +```text +C:\Hugo +├── Bin # Binaries +└┬─ Sites # Hugo Site Repositories + └── alguidelines # Hugo Source for alguidelines.dev +``` + +{{% /alert %}} + +![image](SelectExtended.png) + +After downloading the .zip file, extract the zip-file to `c:\Hugo\Bin` + +![image](Extract.png) + +![image](ExtractToBin.png) + +## Add Hugo to Path + +After copying the binaries to Your PC, You will need to add Hugo binaries to the `%PATH%` system environment variables. + +To do that, search for `environment` + +![image](SearchForEnv.png) + +once you see the `Edit the system environment variables`, open it and select `Environment Variables` + +![image](SystemProperties.png) + +Once the Environment Variables screen is open, highlight the `Path` lines and press the `Edit...` button + +![image](EnvironmentVariables.png) + +Now press `New` and add the `C:\Hugo\Bin` to the path. Press `OK` and `OK` to save the new `Path` + +![image](EnvironmentVariablesPath.png) + +Once complete. You should now be able to preview the Hugo site on by opening a command promt, and open the `C:\Hugo\Sites\alguidelines` folder and execute `Hugo Serve` + +![image](HugoServe.png) \ No newline at end of file diff --git a/content/docs/Contributing/InstallHugo/UsingPowershellOnWindows11/index.md b/content/docs/Contributing/InstallHugo/UsingPowershellOnWindows11/index.md new file mode 100644 index 00000000..3b64af8f --- /dev/null +++ b/content/docs/Contributing/InstallHugo/UsingPowershellOnWindows11/index.md @@ -0,0 +1,22 @@ +--- +Title: Powershell on Windows 11 +description: > + Install Hugo with a simple Powershell Script and chocolatey +--- + +It is possible to use a powershell script and Chocolatey to install and other dependencies. Execute the following script: + +```powershell +Set-ExecutionPolicy Bypass -Scope Process -Force +[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072 +Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1')) +choco install -y nodejs +choco install -y hugo-extended +``` + +Once complete, in root of of the repository execute the following commands + +```powershell +git submodule update --init --recursive --depth 1 +npm install +``` diff --git a/content/docs/Contributing/InstallHugo/_index.md b/content/docs/Contributing/InstallHugo/_index.md new file mode 100644 index 00000000..b59eb861 --- /dev/null +++ b/content/docs/Contributing/InstallHugo/_index.md @@ -0,0 +1,9 @@ +--- +title: Install Hugo +--- + +There are multiple ways to install Hugo for you to properly preview your contributions. Please select the scenario that matches your setup. + +For the official install guide, you can visit + +{{< youtube G7umPCU-8xc >}}