output/blog/2022/03/30/website-updates.html - libcloud-site - Git at Google

 <!DOCTYPE html>
 <html lang="en">
   <head>
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">


     <meta name="author" content="The Apache Software Foundation">


       <meta name="keywords" content="news,infrastructure,website,git" />


       <title>Website Updates | Apache Libcloud</title>


     <!-- fav icons -->
     <link rel="shortcut icon" href="/images/favicon.png" />
     <link rel="apple-touch-icon" href="/images/apple-touch-icon.png" />
     <link rel="apple-touch-icon-precomposed" href="/images/apple-touch-icon.png" />

     <link href="/blog/atom.xml" type="application/atom+xml" rel="alternate" title="Apache Libcloud Blog Feed" />

     <!-- Facebook OpenGraph tags -->
     <meta content="Apache Libcloud" property="og:site_name">

       <meta content="Website Updates" property="og:title">


       <meta content="article" property="og:type">


       <meta content="https://libcloud.apache.org/blog/2022/03/30/website-updates.html" property="og:url">


       <meta content="2022-03-30T00:00:00+00:00" property="article:published_time">
       <meta content="https://libcloud.apache.org/about.html" property="article:author">


       <meta content="news" property="article:tag">

       <meta content="infrastructure" property="article:tag">

       <meta content="website" property="article:tag">

       <meta content="git" property="article:tag">


     <link href='/assets/global-0faf439f2f098e60d3f1e591316155fc.css' rel='stylesheet' type='text/css' />
   </head>

   <body data-spy="scroll" data-target=".sidebar-nav" data-offset="80">
     <nav class="navbar navbar-fixed-top navbar-inverse" role="navigation">
       <div class="container">
         <div class="navbar-header">
           <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-ex1-collapse">
             <span class="sr-only">Toggle navigation</span>
             <span class="icon-bar"></span>
             <span class="icon-bar"></span>
             <span class="icon-bar"></span>
           </button>
           <a class="navbar-brand" href="/"><img src="/images/libcloud_logo.png" class="navbar-logo" /> Apache Libcloud</a>
         </div>
         <div class="collapse navbar-collapse navbar-ex1-collapse">
           <ul class="nav navbar-nav">


               <li ><a href="/" >Home</a></li>


               <li ><a href="/about.html" >About</a></li>


               <li ><a href="/getting-started.html" >Quick Start</a></li>


               <li ><a href="https://libcloud.readthedocs.org/en/stable/" target="_blank">Documentation</a></li>


               <li ><a href="/downloads.html" >Downloads</a></li>


               <li ><a href="/community.html" >Community</a></li>


               <li ><a href="/blog/" >Blog</a></li>

           </ul>

           <div class="material-switch pull-right">
               <input id="theme-switch" name="theme-switch" type="checkbox" onclick="modeSwitcher()"/>
               <label for="theme-switch" class="label-default"></label>
               <span id="theme-toggle" class="theme-switch">Dark mode</span>
           </div>

         </div><!-- /.navbar-collapse -->
       </div><!-- /.container -->
     </nav>

     <div class="container main-container">
       <div class="row section page-content">
   <div class="col-lg-8 col-lg-offset-2">

 <div class="post">

     <h2 class="post-title">Website Updates</h2>

   <span class="post-date-author">By Tomaz Muraus on Mar 30, 2022</span>

   <div class="post-content">
     <p>Today we are happy to announce various website updates. Here is a short
 summary of those updates.</p>

 <ul>
   <li>Move from svn to git for storing the website source code and the
 generated static content (<a href="https://github.com/apache/libcloud-site">https://github.com/apache/libcloud-site</a>)</li>
   <li>New Docker image to make it easier to build and contribute to the website</li>
   <li>Upgrades to the various software and libraries used to build and serve
 the website (Jekyll, Ruby, Ruby Gems, jQuery, Bootstrap, etc.).</li>
   <li>Dark mode / theme for the website</li>
   <li>Removal of Google tracking code (Google Analytics, Google Fonts)</li>
   <li>Removal of various Ruby gems which are not needed to build the website</li>
   <li>Other minor styling improvements</li>
 </ul>

 <div class="imginline">
   <p><img src="/images/posts/tbd/dark_theme.png" class="img-responsive inline" /></p>
   <p class="img-caption">Website using dark mode.</p>
 </div>

 <p>More on that below.</p>

 <h2 id="background-context">Background, Context</h2>

 <p>It has been over 8 years since the new static <a href="https://libcloud.apache.org/blog/2014/01/23/welcome-to-the-new-website.html">Jekyll powered website has
 been launched</a>.</p>

 <p>8 years is a long time and since then a lot has changed. Especially in the web
 world, but the website stayed more or less the same.</p>

 <p>Since the website is purely static and doesn’t contain any dynamic server side
 components this means that not updating the software which is used to build the
 website has no negative security implications for the end users (that’s a nice
 thing about all the static website generators). This is vastly different if you
 run a server side CMS such as Wordpress or similar where you need to make sure
 it’s always up to date with the latest security patches.</p>

 <p>Main problem with using old software (Ruby, Jekyll) was that it was very hard
 to reproduce local development environment which made it almost impossible for
 others to contribute - even I had issues with reproducing the environment in
 the past year.</p>

 <p>We used Ruby 1.9 and Jekyll 1.5 which were both almost 8 years old and
 officially deprecated and non-supported for many years already.</p>

 <p>At first, I only wanted to create a Docker image with this old software which
 would make it easier for other people to contribute and build the website
 locally.</p>

 <p>It turned out that even that is very hard now because of the various old
 versions of the software and libraries that software depends on. After
 many hours, I did <a href="https://libcloud.apache.org/blog/2014/01/23/welcome-to-the-new-website.html">get it to work</a>, but I decide to try to go a step
 further and see if I can actually update Ruby and Jekyll.</p>

 <p>And surely, it turned out that’s not an easy task either. Over the years,
 Jekyll had many releases with breaking changes and to make things worse, we
 also utilize some custom Jekyll plugins which needed to be updated (I was
 actually already somewhat aware I’m opening a can of worms because I
 already tried to do that a couple of times in the past, but each time I
 decided to abandon those efforts since it required too much work / time).</p>

 <p>In the end, after addressing all of those various issues and breaking changes,
 I got everything to work.</p>

 <p>To make contributing even easier and faster, we also provide a pre-built Docker
 image with the development environment which should save some time and CPU
 cycles since the image doesn’t need to be built locally (sadly the image is on
 the larger side because a lot of tooling is needed to build the website - I do
 hope to reduce that a bit in a future when I get a chance by using a multi
 stage build).</p>

 <p>Since I was already working on the website I also decided to make a bunch of
 other changes, my favorite one being dark mode / theme. I personally already
 use <a href="https://addons.mozilla.org/sl/firefox/addon/darkreader/">Dark Reader extension for Firefox</a> which automatically provides dark
 mode for most websites on the fly, but I know now everyone is using something
 like that and a native dark mode / theme is usually better.</p>

 <p>The source code and everything else for the new website is available at
 <a href="https://github.com/apache/libcloud-site">https://github.com/apache/libcloud-site</a>.</p>

 <h2 id="conclusion">Conclusion</h2>

 <p>We hope you will enjoy those new changes and most importantly, we hope
 those changes will decrease the barrier to entry and make contributing to
 the website easier and faster.</p>

 <p>P.S. If you find any bugs or issues with those changes (especially the dark
 theme), please feel free to report them or, if possible, contribute the fix
 directly - that would be much appreciated.</p>


   </div>

   <div class="row section post-meta">
     <div class="col-md-12 post-tags">
       <p>Tags: <a href="/blog/tags/news.html" rel="tag">news</a>, <a href="/blog/tags/infrastructure.html" rel="tag">infrastructure</a>, <a href="/blog/tags/website.html" rel="tag">website</a>, <a href="/blog/tags/git.html" rel="tag">git</a></p>
     </div>
   </div>
 </div>


   </div>
 </div>


       <hr />

       <footer>
         <div class="row">
           <div class="col-lg-12 text-center">
             <div class="footer-links">
   <p><a href="http://www.apache.org/licenses/">License</a> | <a
   href="/security.html">Security</a> | <a
   href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a> |
   <a href="http://www.apache.org/foundation/thanks.html">Thanks</a> |
   <a href="https://www.apache.org/events/">Events</a> |
   <a href="/credits.html">Credits</a> | <a href="/media.html">Media</a>
 </div>

 <div class="footer-text">
   <p><a class="acevent" data-format="wide"></a></p>
   <p class="">Copyright &copy; 2009-2023 <a href="https://www.apache.org/" target="_blank">The Apache Software Foundation</a></p>
   <p class="">Apache Libcloud, Libcloud, Apache, the Apache feather, and the Apache Libcloud project logo are trademarks of the Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.</p>
   <p class="">Site last updated on 2023-09-09 21:30:54 +0000</p>
 </div>

           </div>
         </div>
       </footer>

     </div><!-- /.container -->

     <!-- JavaScript -->
     <script src='/assets/global-dac9eed9206cf02359a2dd1d7c03e401.js' type='text/javascript'></script>


     <script type="text/javascript">
   var _paq = window._paq = window._paq || [];
   /* tracker methods like "setCustomDimension" should be called before
 "trackPageView" */
   /* We explicitly disable cookie tracking to avoid privacy issues */
   _paq.push(['disableCookies']);
   _paq.push(['trackPageView']);
   _paq.push(['enableLinkTracking']);
   (function() {
     var u="https://analytics.apache.org/";
     _paq.push(['setTrackerUrl', u+'matomo.php']);
     _paq.push(['setSiteId', '7']);
     var d=document, g=d.createElement('script'),
 s=d.getElementsByTagName('script')[0];
     g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
   })();
 </script>

     <script src="https://www.apachecon.com/event-images/snippet.js"></script>

   </body>
 </html>
	<!DOCTYPE html>
	<html lang="en">
	<head>
	<meta charset="utf-8">
	<meta name="viewport" content="width=device-width, initial-scale=1.0">



	<meta name="author" content="The Apache Software Foundation">


	<meta name="keywords" content="news,infrastructure,website,git" />



	<title>Website Updates \| Apache Libcloud</title>


	<!-- fav icons -->
	<link rel="shortcut icon" href="/images/favicon.png" />
	<link rel="apple-touch-icon" href="/images/apple-touch-icon.png" />
	<link rel="apple-touch-icon-precomposed" href="/images/apple-touch-icon.png" />

	<link href="/blog/atom.xml" type="application/atom+xml" rel="alternate" title="Apache Libcloud Blog Feed" />

	<!-- Facebook OpenGraph tags -->
	<meta content="Apache Libcloud" property="og:site_name">

	<meta content="Website Updates" property="og:title">







	<meta content="article" property="og:type">



	<meta content="https://libcloud.apache.org/blog/2022/03/30/website-updates.html" property="og:url">


	<meta content="2022-03-30T00:00:00+00:00" property="article:published_time">
	<meta content="https://libcloud.apache.org/about.html" property="article:author">




	<meta content="news" property="article:tag">

	<meta content="infrastructure" property="article:tag">

	<meta content="website" property="article:tag">

	<meta content="git" property="article:tag">



	<link href='/assets/global-0faf439f2f098e60d3f1e591316155fc.css' rel='stylesheet' type='text/css' />
	</head>

	<body data-spy="scroll" data-target=".sidebar-nav" data-offset="80">
	<nav class="navbar navbar-fixed-top navbar-inverse" role="navigation">
	<div class="container">
	<div class="navbar-header">
	<button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-ex1-collapse">
	<span class="sr-only">Toggle navigation</span>
	<span class="icon-bar"></span>
	<span class="icon-bar"></span>
	<span class="icon-bar"></span>
	</button>
	<a class="navbar-brand" href="/"><img src="/images/libcloud_logo.png" class="navbar-logo" /> Apache Libcloud</a>
	</div>
	<div class="collapse navbar-collapse navbar-ex1-collapse">
	<ul class="nav navbar-nav">



	<li ><a href="/" >Home</a></li>


	<li ><a href="/about.html" >About</a></li>


	<li ><a href="/getting-started.html" >Quick Start</a></li>


	<li ><a href="https://libcloud.readthedocs.org/en/stable/" target="_blank">Documentation</a></li>


	<li ><a href="/downloads.html" >Downloads</a></li>


	<li ><a href="/community.html" >Community</a></li>


	<li ><a href="/blog/" >Blog</a></li>

	</ul>

	<div class="material-switch pull-right">
	<input id="theme-switch" name="theme-switch" type="checkbox" onclick="modeSwitcher()"/>
	<label for="theme-switch" class="label-default"></label>
	<span id="theme-toggle" class="theme-switch">Dark mode</span>
	</div>

	</div><!-- /.navbar-collapse -->
	</div><!-- /.container -->
	</nav>

	<div class="container main-container">
	<div class="row section page-content">
	<div class="col-lg-8 col-lg-offset-2">

	<div class="post">

	<h2 class="post-title">Website Updates</h2>

	<span class="post-date-author">By Tomaz Muraus on Mar 30, 2022</span>

	<div class="post-content">
	<p>Today we are happy to announce various website updates. Here is a short
	summary of those updates.</p>

	<ul>
	<li>Move from svn to git for storing the website source code and the
	generated static content (<a href="https://github.com/apache/libcloud-site">https://github.com/apache/libcloud-site</a>)</li>
	<li>New Docker image to make it easier to build and contribute to the website</li>
	<li>Upgrades to the various software and libraries used to build and serve
	the website (Jekyll, Ruby, Ruby Gems, jQuery, Bootstrap, etc.).</li>
	<li>Dark mode / theme for the website</li>
	<li>Removal of Google tracking code (Google Analytics, Google Fonts)</li>
	<li>Removal of various Ruby gems which are not needed to build the website</li>
	<li>Other minor styling improvements</li>
	</ul>

	<div class="imginline">
	<p><img src="/images/posts/tbd/dark_theme.png" class="img-responsive inline" /></p>
	<p class="img-caption">Website using dark mode.</p>
	</div>

	<p>More on that below.</p>

	<h2 id="background-context">Background, Context</h2>

	<p>It has been over 8 years since the new static <a href="https://libcloud.apache.org/blog/2014/01/23/welcome-to-the-new-website.html">Jekyll powered website has
	been launched</a>.</p>

	<p>8 years is a long time and since then a lot has changed. Especially in the web
	world, but the website stayed more or less the same.</p>

	<p>Since the website is purely static and doesn’t contain any dynamic server side
	components this means that not updating the software which is used to build the
	website has no negative security implications for the end users (that’s a nice
	thing about all the static website generators). This is vastly different if you
	run a server side CMS such as Wordpress or similar where you need to make sure
	it’s always up to date with the latest security patches.</p>

	<p>Main problem with using old software (Ruby, Jekyll) was that it was very hard
	to reproduce local development environment which made it almost impossible for
	others to contribute - even I had issues with reproducing the environment in
	the past year.</p>

	<p>We used Ruby 1.9 and Jekyll 1.5 which were both almost 8 years old and
	officially deprecated and non-supported for many years already.</p>

	<p>At first, I only wanted to create a Docker image with this old software which
	would make it easier for other people to contribute and build the website
	locally.</p>

	<p>It turned out that even that is very hard now because of the various old
	versions of the software and libraries that software depends on. After
	many hours, I did <a href="https://libcloud.apache.org/blog/2014/01/23/welcome-to-the-new-website.html">get it to work</a>, but I decide to try to go a step
	further and see if I can actually update Ruby and Jekyll.</p>

	<p>And surely, it turned out that’s not an easy task either. Over the years,
	Jekyll had many releases with breaking changes and to make things worse, we
	also utilize some custom Jekyll plugins which needed to be updated (I was
	actually already somewhat aware I’m opening a can of worms because I
	already tried to do that a couple of times in the past, but each time I
	decided to abandon those efforts since it required too much work / time).</p>

	<p>In the end, after addressing all of those various issues and breaking changes,
	I got everything to work.</p>

	<p>To make contributing even easier and faster, we also provide a pre-built Docker
	image with the development environment which should save some time and CPU
	cycles since the image doesn’t need to be built locally (sadly the image is on
	the larger side because a lot of tooling is needed to build the website - I do
	hope to reduce that a bit in a future when I get a chance by using a multi
	stage build).</p>

	<p>Since I was already working on the website I also decided to make a bunch of
	other changes, my favorite one being dark mode / theme. I personally already
	use <a href="https://addons.mozilla.org/sl/firefox/addon/darkreader/">Dark Reader extension for Firefox</a> which automatically provides dark
	mode for most websites on the fly, but I know now everyone is using something
	like that and a native dark mode / theme is usually better.</p>

	<p>The source code and everything else for the new website is available at
	<a href="https://github.com/apache/libcloud-site">https://github.com/apache/libcloud-site</a>.</p>

	<h2 id="conclusion">Conclusion</h2>

	<p>We hope you will enjoy those new changes and most importantly, we hope
	those changes will decrease the barrier to entry and make contributing to
	the website easier and faster.</p>

	<p>P.S. If you find any bugs or issues with those changes (especially the dark
	theme), please feel free to report them or, if possible, contribute the fix
	directly - that would be much appreciated.</p>


	</div>

	<div class="row section post-meta">
	<div class="col-md-12 post-tags">
	<p>Tags: <a href="/blog/tags/news.html" rel="tag">news</a>, <a href="/blog/tags/infrastructure.html" rel="tag">infrastructure</a>, <a href="/blog/tags/website.html" rel="tag">website</a>, <a href="/blog/tags/git.html" rel="tag">git</a></p>
	</div>
	</div>
	</div>


	</div>
	</div>


	<hr />

	<footer>
	<div class="row">
	<div class="col-lg-12 text-center">
	<div class="footer-links">
	<p><a href="http://www.apache.org/licenses/">License</a> \| <a
	href="/security.html">Security</a> \| <a
	href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a> \|
	<a href="http://www.apache.org/foundation/thanks.html">Thanks</a> \|
	<a href="https://www.apache.org/events/">Events</a> \|
	<a href="/credits.html">Credits</a> \| <a href="/media.html">Media</a>
	</div>

	<div class="footer-text">
	<p><a class="acevent" data-format="wide"></a></p>
	<p class="">Copyright © 2009-2023 <a href="https://www.apache.org/" target="_blank">The Apache Software Foundation</a></p>
	<p class="">Apache Libcloud, Libcloud, Apache, the Apache feather, and the Apache Libcloud project logo are trademarks of the Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.</p>
	<p class="">Site last updated on 2023-09-09 21:30:54 +0000</p>
	</div>

	</div>
	</div>
	</footer>

	</div><!-- /.container -->

	<!-- JavaScript -->
	<script src='/assets/global-dac9eed9206cf02359a2dd1d7c03e401.js' type='text/javascript'></script>



	<script type="text/javascript">
	var _paq = window._paq = window._paq \|\| [];
	/* tracker methods like "setCustomDimension" should be called before
	"trackPageView" */
	/* We explicitly disable cookie tracking to avoid privacy issues */
	_paq.push(['disableCookies']);
	_paq.push(['trackPageView']);
	_paq.push(['enableLinkTracking']);
	(function() {
	var u="https://analytics.apache.org/";
	_paq.push(['setTrackerUrl', u+'matomo.php']);
	_paq.push(['setSiteId', '7']);
	var d=document, g=d.createElement('script'),
	s=d.getElementsByTagName('script')[0];
	g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
	})();
	</script>

	<script src="https://www.apachecon.com/event-images/snippet.js"></script>

	</body>
	</html>