alguidelines/docs/contributing/installhugo/index.xml
2022-02-25 16:47:14 +00:00

41 lines
No EOL
7.3 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>alguidelines.dev - Business Central Design Patterns Install Hugo</title><link>https://alguidelines.dev/docs/contributing/installhugo/</link><description>Recent content in Install Hugo on alguidelines.dev - Business Central Design Patterns</description><generator>Hugo -- gohugo.io</generator><language>en-us</language><atom:link href="https://alguidelines.dev/docs/contributing/installhugo/index.xml" rel="self" type="application/rss+xml"/><item><title>Docs: Manually on Windows 11</title><link>https://alguidelines.dev/docs/contributing/installhugo/manuallyonwindows11/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://alguidelines.dev/docs/contributing/installhugo/manuallyonwindows11/</guid><description>
&lt;p>This guide will walk You thrugh installing Hugo on a Windows 11 PC. For the official install guide, You can wisit &lt;a href="https://gohugo.io/getting-started/installing/">https://gohugo.io/getting-started/installing/&lt;/a>.&lt;/p>
&lt;h2 id="download-binaries">Download Binaries&lt;/h2>
&lt;p>The path of least resistance is to just download the .zip file from the official Hugo GitHub Repository &lt;a href="https://github.com/gohugoio/hugo/releases">here&lt;/a>.&lt;/p>
&lt;p>The theme that are used, needs the extended version of Hugo, so make sure to download the &lt;strong>extended&lt;/strong> version by ensuring the file name starts with &lt;code>hugo_extended...&lt;/code>&lt;/p>
&lt;div class="alert alert-info" role="alert">
&lt;h4 class="alert-heading">info&lt;/h4>
&lt;p>For the purpose of this install guide, we are assuming You will want to follow the &amp;ldquo;standard&amp;rdquo; used by Hugo for installing. We will be creating a &lt;code>Hugo&lt;/code> folder in the root of &lt;code>C:\&lt;/code>. That folder will have a &lt;code>Bin&lt;/code> folder for the binaries, and a &lt;code>Sites&lt;/code> folder for each website You are building.&lt;/p>
&lt;p>Once You are done, You should have a folder structure that looks like this:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4">&lt;code class="language-text" data-lang="text">C:\Hugo
├── Bin # Binaries
└┬─ Sites # Hugo Site Repositories
└── alguidelines # Hugo Source for alguidelines.dev
&lt;/code>&lt;/pre>&lt;/div>
&lt;/div>
&lt;p>&lt;img src="SelectExtended.png" alt="image">&lt;/p>
&lt;p>After downloading the .zip file, extract the zip-file to &lt;code>c:\Hugo\Bin&lt;/code>&lt;/p>
&lt;p>&lt;img src="Extract.png" alt="image">&lt;/p>
&lt;p>&lt;img src="ExtractToBin.png" alt="image">&lt;/p>
&lt;h2 id="add-hugo-to-path">Add Hugo to Path&lt;/h2>
&lt;p>After copying the binaries to Your PC, You will need to add Hugo binaries to the &lt;code>%PATH%&lt;/code> system environment variables.&lt;/p>
&lt;p>To do that, search for &lt;code>environment&lt;/code>&lt;/p>
&lt;p>&lt;img src="SearchForEnv.png" alt="image">&lt;/p>
&lt;p>once you see the &lt;code>Edit the system environment variables&lt;/code>, open it and select &lt;code>Environment Variables&lt;/code>&lt;/p>
&lt;p>&lt;img src="SystemProperties.png" alt="image">&lt;/p>
&lt;p>Once the Environment Variables screen is open, highlight the &lt;code>Path&lt;/code> lines and press the &lt;code>Edit...&lt;/code> button&lt;/p>
&lt;p>&lt;img src="EnvironmentVariables.png" alt="image">&lt;/p>
&lt;p>Now press &lt;code>New&lt;/code> and add the &lt;code>C:\Hugo\Bin&lt;/code> to the path. Press &lt;code>OK&lt;/code> and &lt;code>OK&lt;/code> to save the new &lt;code>Path&lt;/code>&lt;/p>
&lt;p>&lt;img src="EnvironmentVariablesPath.png" alt="image">&lt;/p>
&lt;p>Once complete. You should now be able to preview the Hugo site on &lt;a href="http://localhost:1313">http://localhost:1313&lt;/a> by opening a command promt, and open the &lt;code>C:\Hugo\Sites\alguidelines&lt;/code> folder and execute &lt;code>Hugo Serve&lt;/code>&lt;/p>
&lt;p>&lt;img src="HugoServe.png" alt="image">&lt;/p></description></item><item><title>Docs: Powershell on Windows 11</title><link>https://alguidelines.dev/docs/contributing/installhugo/usingpowershellonwindows11/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://alguidelines.dev/docs/contributing/installhugo/usingpowershellonwindows11/</guid><description>
&lt;p>It is possible to use a powershell script and Chocolatey to install and other dependencies. Execute the following script:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4">&lt;code class="language-powershell" data-lang="powershell">&lt;span style="color:#204a87">Set-ExecutionPolicy&lt;/span> &lt;span style="color:#000">Bypass&lt;/span> &lt;span style="color:#000">-Scope&lt;/span> &lt;span style="color:#204a87;font-weight:bold">Process&lt;/span> &lt;span style="color:#000">-Force&lt;/span>
&lt;span style="color:#000">[System.Net.ServicePointManager]&lt;/span>&lt;span style="color:#000;font-weight:bold">::&lt;/span>&lt;span style="color:#000">SecurityProtocol&lt;/span> &lt;span style="color:#000;font-weight:bold">=&lt;/span> &lt;span style="color:#000">[System.Net.ServicePointManager]&lt;/span>&lt;span style="color:#000;font-weight:bold">::&lt;/span>&lt;span style="color:#000">SecurityProtocol&lt;/span> &lt;span style="color:#ce5c00;font-weight:bold">-bor&lt;/span> &lt;span style="color:#000">3072&lt;/span>
&lt;span style="color:#204a87">Invoke-Expression&lt;/span> &lt;span style="color:#000;font-weight:bold">((&lt;/span>&lt;span style="color:#204a87">New-Object&lt;/span> &lt;span style="color:#000">System&lt;/span>&lt;span style="color:#000;font-weight:bold">.&lt;/span>&lt;span style="color:#000">Net&lt;/span>&lt;span style="color:#000;font-weight:bold">.&lt;/span>&lt;span style="color:#000">WebClient&lt;/span>&lt;span style="color:#000;font-weight:bold">).&lt;/span>&lt;span style="color:#000">DownloadString&lt;/span>&lt;span style="color:#000;font-weight:bold">(&lt;/span>&lt;span style="color:#4e9a06">&amp;#39;https://community.chocolatey.org/install.ps1&amp;#39;&lt;/span>&lt;span style="color:#000;font-weight:bold">))&lt;/span>
&lt;span style="color:#000">choco&lt;/span> &lt;span style="color:#000">install&lt;/span> &lt;span style="color:#000">-y&lt;/span> &lt;span style="color:#000">nodejs&lt;/span>
&lt;span style="color:#000">choco&lt;/span> &lt;span style="color:#000">install&lt;/span> &lt;span style="color:#000">-y&lt;/span> &lt;span style="color:#204a87">hugo-extended&lt;/span>
&lt;/code>&lt;/pre>&lt;/div>&lt;p>Once complete, in root of of the repository execute the following commands&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4">&lt;code class="language-powershell" data-lang="powershell">&lt;span style="color:#000">git&lt;/span> &lt;span style="color:#000">submodule&lt;/span> &lt;span style="color:#000">update&lt;/span> &lt;span style="color:#000;font-weight:bold">-&lt;/span>&lt;span style="color:#000">-init&lt;/span> &lt;span style="color:#000;font-weight:bold">-&lt;/span>&lt;span style="color:#000">-recursive&lt;/span> &lt;span style="color:#000;font-weight:bold">-&lt;/span>&lt;span style="color:#000">-depth&lt;/span> &lt;span style="color:#000">1&lt;/span>
&lt;span style="color:#000">npm&lt;/span> &lt;span style="color:#000">install&lt;/span>
&lt;/code>&lt;/pre>&lt;/div></description></item></channel></rss>