Skip to content

Commit

Permalink
deploy: 54f3c77
Browse files Browse the repository at this point in the history
  • Loading branch information
aperezdc committed Feb 28, 2024
1 parent cccccce commit bb20967
Show file tree
Hide file tree
Showing 630 changed files with 233,184 additions and 0 deletions.
1 change: 1 addition & 0 deletions aperezdc/learn-discover-rework/.stamp
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Wed Feb 28 15:36:22 UTC 2024
46 changes: 46 additions & 0 deletions aperezdc/learn-discover-rework/README/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
<h1>wpewebkit.org</h1>
<p>wepwebkit.org is a statically generated site for WPE. The website aims to be simple to maintain and with little complexity and dependencies. It is built with <a href="https://www.11ty.dev/">11ty</a> and Liquid templates - and that’s pretty much it.</p>
<p>The actual site is hosted by <a href="https://igalia.com">Igalia</a> who are the primary maintainers of the project.</p>
<h2 id="development" tabindex="-1">Development</h2>
<p>In order to setup, you just just have to check it out, switch to the checked out directory and then <code>npm install</code>.</p>
<h2 id="building-wpewebkit.org-site-locally" tabindex="-1">Building wpewebkit.org site locally</h2>
<p>In order to test it all you need to do is</p>
<pre class="language-sh"><code class="language-sh"><span class="token function">npm</span> <span class="token function">install</span> <span class="token operator">&amp;&amp;</span> <span class="token function">npm</span> run serve</code></pre>
<p>This will build the project, start a server, and your terminal will provide you useful links to actually get to it.</p>
<h3 id="structure" tabindex="-1">Structure</h3>
<ul>
<li>
<p><code>_site</code> is the output folder, where the generated and served content lives. It is committed and github pages used to provide a sharable dev URL in case you want to discuss proposed changes easily or test for something without exposing things behind your own firewall.</p>
</li>
<li>
<p><code>_includes</code> contains templates and partials. Currently our templates are based on a variant of <a href="https://startbootstrap.com/template-overviews/stylish-portfolio/">Stylish Portfolio</a> simply because that is what we had to start with.</p>
</li>
<li>
<p><code>_posts</code> contains much of the actual content: release notes, security advisories, posts, etc as <code>.md</code> files with front matter. These generate individual .html files in <code>_site</code>.</p>
</li>
<li>
<p><code>assets</code> contain images and things, they are copied directly into their relevant directory in <code>_site</code>.</p>
</li>
<li>
<p><code>css</code> This is where <em>our</em> CSS goes. Currently, our CSS is overrides and customizations for the <a href="https://startbootstrap.com/template-overviews/stylish-portfolio/">Stylish Portfolio</a> CSS. <em>There is no preprocessing</em> at the moment.</p>
</li>
<li>
<p><code>release</code> contains the markdown and directory structure for the release schedule page.</p>
</li>
<li>
<p><code>vendor</code> this contains thirdparty stuff that we will use directly in the site - it is copied wholesale into its relevant spot in the output directory (<code>_site</code>). <em>There is currently too much in there</em> - our page uses stylish portfolio, which uses bootstrap, which uses jQuery and font-awesome and simple-line-icons. These in turn contain things for bundling, pre-processing with several different preprocessors, etc. We will probably simplify this further, that’s a lot of downloads, code and round-trips for such a simple site.</p>
</li>
<li>
<p><code>about</code> contains page posts that are about various aspects of wpe</p>
</li>
</ul>
<p>In the root directory you will also find some top level files - <code>index.html</code>which is the template for the main page, <code>release.md</code> which is the template for creating the release pages, a <code>package.json</code> which is, well, what you’d expect and <code>.eleventy.js</code> which does some very understandable work in creating a date filter for outputting dates (because of how some of the old content exists), and creates some ‘recent’ collections for simple templating of things like release notes and security advisories.</p>
<h2 id="updating-wpewebkit.org-site" tabindex="-1">Updating wpewebkit.org site</h2>
<ul>
<li>The website is automatically updated from this repository. So simply commit to master or send a pull-request.</li>
</ul>
<h2 id="updating-content" tabindex="-1">Updating content</h2>
<p>In order to write a new release or security advisory piece in the website
you just have to create a new file inside <code>_posts</code> folder using
<a href="http://daringfireball.net/projects/markdown/">Markdown</a> syntax.</p>
<p>Should you need anything else, you will find <a href="https://www.11ty.dev/docs/">11ty’s documentation</a> pretty helpful.</p>
17 changes: 17 additions & 0 deletions aperezdc/learn-discover-rework/_authors/aperez/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
<section class="content-section bg-light small-section">
<div class="container">
<div class="row">
<div class="col-lg-10 mx-auto text-muted text-left align-text-top">
<hr class="author-line">
<div class="card">
<img class="circle-mask" width="128" height="128" loading="lazy" alt="Head shot of Adrián Pérez" src="/wpewebkit.org/aperezdc/learn-discover-rework/assets/[email protected]" srcset="/wpewebkit.org/aperezdc/learn-discover-rework/assets/[email protected] 2x">
This article was written by <a href="https://igalia.com/team/aperez">Adrián Pérez</a>.
<br>
I have been working on WebKit since 2012, with a focus on
environment integration, embedding, and distribution. Igalia
has been a life-long project since even earlier.
</div>
</div>
</div>
</div>
</section>
14 changes: 14 additions & 0 deletions aperezdc/learn-discover-rework/_authors/csaavedra/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
<section class="content-section bg-light small-section">
<div class="container">
<div class="row">
<div class="col-lg-10 mx-auto text-muted text-left align-text-top">
<hr class="author-line">
<div class="card">
<span>
This article was written by <a href="https://www.igalia.com/team/csaavedra">Claudio Saavedra</a>. <br><br>Claudio is long-time WebKit contributor from Igalia, working in different areas of WebKit, WPE, and the stack around it.
</span>
</div>
</div>
</div>
</div>
</section>
18 changes: 18 additions & 0 deletions aperezdc/learn-discover-rework/_authors/llepage/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
<section class="content-section bg-light small-section">
<div class="container">
<div class="row">
<div class="col-lg-10 mx-auto text-muted text-left align-text-top">
<hr class="author-line">
<div class="card">
<img class="circle-mask" width="128" height="128" loading="lazy" alt="Head shot of Loïc Le Page" src="/wpewebkit.org/aperezdc/learn-discover-rework/assets/[email protected]" srcset="/wpewebkit.org/aperezdc/learn-discover-rework/assets/[email protected] 2x">
This article was written by <a href="https://igalia.com/team/llepage">Loïc Le Page</a>.
<br>
I have worked in different industries like video games,
cinema, and multimedia&mdash;the latter being where my
focus lies at the moment. Did anyone say Web engines need
that, too?
</div>
</div>
</div>
</div>
</section>
15 changes: 15 additions & 0 deletions aperezdc/learn-discover-rework/_authors/lmoura/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
<section class="content-section bg-light small-section">
<div class="container">
<div class="row">
<div class="col-lg-10 mx-auto text-muted text-left align-text-top">
<hr class="author-line">
<div class="card">
<span>
This article was written by <a href="https://www.igalia.com/team/lmoura">Lauro Moura</a>. <br><br>Lauro is webkit contributor from Igalia, working mainly on QA.
</span>
</div>
</div>
</div>
</div>
</section>

14 changes: 14 additions & 0 deletions aperezdc/learn-discover-rework/_authors/magomez/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
<section class="content-section bg-light small-section">
<div class="container">
<div class="row">
<div class="col-lg-10 mx-auto text-muted text-left align-text-top">
<hr class="author-line">
<div class="card">
<span>
This article was written by <a href="https://www.igalia.com/team/magomez">Miguel Gómez</a>. <br><br>Miguel has been contributing to WebKit and WPE for almost ten years now, focusing specially on the graphics part of the code.
</span>
</div>
</div>
</div>
</div>
</section>
15 changes: 15 additions & 0 deletions aperezdc/learn-discover-rework/_authors/nzimmermann/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
<section class="content-section bg-light small-section">
<div class="container">
<div class="row">
<div class="col-lg-10 mx-auto text-muted text-left align-text-top">
<hr class="author-line">
<div class="card">
<span>
<img class="circle-mask" src="https://www.igalia.com/assets/i/igalians/nzimmermann.jpg" alt="Picture of Nikolas Zimmermann">
This article was written by <a href="https://www.igalia.com/team/nzimmermann">Nikolas Zimmermann</a>. <br><br>I'm a proud Igalian since 2019 and have been working on WebKits predecessors since the early 2000s, namely kjs/khtml/ksvg, and kdom/kcanvas/ksvg2/khtml2 that all found their way into WebKit. Since that time, Web technology - especially <b>SVG</b> - is my main area of interest.
</span>
</div>
</div>
</div>
</div>
</section>
15 changes: 15 additions & 0 deletions aperezdc/learn-discover-rework/_authors/pgriffis/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
<section class="content-section bg-light small-section">
<div class="container">
<div class="row">
<div class="col-lg-10 mx-auto text-muted text-left align-text-top">
<hr class="author-line">
<div class="card">
<span>
This article was written by <a href="https://www.igalia.com/team/pgriffis">Patrick Griffis</a>. <br><br>Patrick has been contributing to WebKit since 2018 and does work around networking, security, and the platform libraries WPE uses.
</span>
</div>
</div>
</div>
</div>
</section>

Loading

0 comments on commit bb20967

Please sign in to comment.