https://hbstack.dev/docs/Recent content in User Guide on HB FrameworkHugoenCopyright © 2022-2026 HB Framework. All Rights Reserved.https://hbstack.dev/docs/join-us/Mon, 17 Apr 2023 15:25:17 +0800https://hbstack.dev/docs/join-us/<p>We&rsquo;re glad you plan to join us, and we appreciate any contributions. You can support this project in the following ways.</p>https://hbstack.dev/docs/troubleshooting/Mon, 19 Dec 2022 15:03:19 +0800https://hbstack.dev/docs/troubleshooting/<h2 id="postcss-cli">POSTCSS CLI</h2> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-cobol" data-lang="cobol"><span class="line"><span class="ln">1</span><span class="cl"><span class="c">Error:</span> <span class="kp">Error</span> <span class="nv">building</span> <span class="nv">site</span><span class="p">:</span> <span class="nv">POSTCSS</span><span class="p">:</span> <span class="nv">failed</span> <span class="kp">to</span> <span class="kp">transform </span><span class="s2">&#34;hb/scss/index.css&#34;</span> <span class="p">(</span><span class="err">text</span><span class="o">/</span><span class="nv">css</span><span class="p">).</span> <span class="nv">Check</span> <span class="nv">your</span> <span class="nv">PostCSS</span> <span class="nv">installation</span><span class="p">.</span><span class="err"> </span></span></span></code></pre></div><p>The error above will appear if there isn&rsquo;t POSTCSS CLI installed on your environment.</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="ln">1</span><span class="cl">npm i postcss-cli </span></span></code></pre></div><p>Or</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="ln">1</span><span class="cl">sudo npm i -g postcss-cli </span></span></code></pre></div><h2 id="rtlcss">RTLCSS</h2> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-cobol" data-lang="cobol"><span class="line"><span class="ln">1</span><span class="cl"><span class="c">POSTCS</span><span class="nv">S</span><span class="p">:</span> <span class="nv">failed</span> <span class="kp">to</span> <span class="kp">transform </span><span class="s2">&#34;hb/scss/index.rtl.css&#34;</span> <span class="p">(</span><span class="err">text</span><span class="o">/</span><span class="nv">css</span><span class="p">):</span> <span class="nv">Plugin</span> <span class="kp">Error</span><span class="p">:</span> <span class="nv">Cannot</span> <span class="nv">find</span> <span class="nv">package</span> <span class="s1">&#39;rtlcss&#39;</span> <span class="nv">imported</span> <span class="kp">from </span><span class="o">/</span><span class="nv">usr</span><span class="o">/</span><span class="nv">lib</span><span class="o">/</span><span class="nv">node_modules</span><span class="o">/</span><span class="nv">postcss-cli</span><span class="o">/</span><span class="kp">index</span><span class="p">.</span><span class="nv">js</span><span class="s1">&#39; </span></span></span></code></pre></div><p>The error above will be reached if there isn&rsquo;t RTLCSS installed on your machine.</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="ln">1</span><span class="cl">npm i rtlcss </span></span></code></pre></div><p>Or</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="ln">1</span><span class="cl">sudo npm i -g rtlcss </span></span></code></pre></div><h2 id="purgecss-configuration">PurgeCSS Configuration</h2> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-cobol" data-lang="cobol"><span class="line"><span class="ln">1</span><span class="cl"><span class="c">Error:</span> <span class="kp">Error</span> <span class="nv">building</span> <span class="nv">site</span><span class="p">:</span> <span class="nv">POSTCSS</span><span class="p">:</span> <span class="nv">failed</span> <span class="kp">to</span> <span class="kp">transform </span><span class="s2">&#34;hb/scss/index.css&#34;</span> <span class="p">(</span><span class="err">text</span><span class="o">/</span><span class="nv">css</span><span class="p">):</span> <span class="kp">Error</span><span class="p">:</span> <span class="nv">Failed</span> <span class="kp">to</span> <span class="nv">parse</span> <span class="nv">runtime</span> <span class="nv">PurgeCSS</span> <span class="nv">config</span><span class="p">:</span> <span class="kp">Error</span><span class="p">:</span> <span class="nv">ENOENT</span><span class="p">:</span> <span class="kp">no</span> <span class="nv">such</span> <span class="kr">file</span> <span class="ow">or</span> <span class="nv">directory</span><span class="p">,</span> <span class="kr">open </span><span class="s1">&#39;./public/.build/purgecss.json&#39;</span><span class="p">.</span><span class="err"> </span></span></span><span class="line"><span class="ln">2</span><span class="cl"><span class="c">Please</span> <span class="err">enable</span> <span class="nv">the</span> <span class="s2">&#34;--renderToDisk&#34;</span> <span class="kr">if</span> <span class="nv">you</span> <span class="kp">are</span> <span class="kp">using</span> <span class="nv">Hugo</span> <span class="nv">server</span><span class="p">.</span><span class="err"> </span></span></span></code></pre></div><p>It happens on the case of using Hugo server on production mode without the <code>--renderToDisk</code> and <code>--disableFastRender</code> flags.</p>