Merge branch 'gh-pages' into contributing

chrisdel101 · Jan 22, 2025 · 0c568d1 · 0c568d1
2 parents 6754436 + 899dbfd
commit 0c568d1
Show file tree

Hide file tree

Showing 206 changed files with 2,657 additions and 714 deletions.
diff --git a/.github/workflows/translation.yml b/.github/workflows/translation.yml
diff --git a/404.md b/404.md
@@ -0,0 +1,12 @@
+---
+layout: 404
+title: Page not found
+description: We couldn’t find the page you’re looking for.
+lang: en
+---
+
+# {{ page.title }}
+
+We couldn’t find the page you’re looking for. Check the address or [head back home](/).
+
+If this is a mistake, [let us know](https://github.com/expressjs/expressjs.com/issues/new/), and we will try to fix it!
diff --git a/LICENSE.md b/LICENSE.md
@@ -1,5 +1,7 @@
 # License
 
+Copyright The Express Contributors.
+
 # Creative Commons Attribution-ShareAlike 3.0
 
 CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE LEGAL SERVICES. DISTRIBUTION OF THIS LICENSE DOES NOT CREATE AN ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES REGARDING THE INFORMATION PROVIDED, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM ITS USE.

diff --git a/_data/express.yml b/_data/express.yml
@@ -1,2 +1,2 @@
-current_version: "4.21.1"
+current_version: "4.21.2"
 next_version: "5.0.1"
diff --git a/_includes/announcement/announcement-en.md b/_includes/announcement/announcement-en.md
@@ -1,6 +1,6 @@
 <ul>
   <li>
-    <p class="announcement-title">Express 5.0 documentation is now available.</p>
+    <p class="announcement-title">{% include icons/announcement.svg %} Express 5.0 documentation is now available.</p>
     <p markdown="1">
      The <a href="{{ page.lang }}/5x/api.html">API documentation</a> is a work in progress.  For information on what's in the release, see the Express <a href="https://github.com/expressjs/express/blob/5.0/History.md">release history</a>.
     </p>

diff --git a/_includes/announcement/announcement-id.md b/_includes/announcement/announcement-id.md
@@ -1,6 +1,6 @@
 <ul>
   <li>
-    <p class="announcement-title">Dokumentasi Express 5.0 versi beta kini telah tersedia.</p>
+    <p class="announcement-title">{% include icons/announcement.svg %} Dokumentasi Express 5.0 versi beta kini telah tersedia.</p>
     <p markdown="1">
      <a href="{{ page.lang }}/5x/api.html">Dokumentasi API</a> beta masih dalam proses. Untuk informasi tentang apa yang ada dalam rilis, lihat <a href="https://github.com/expressjs/express/blob/5.0/History.md">riwayat rilis</a> Express.
     </p>

diff --git a/_includes/announcement/announcement-pt-br.md b/_includes/announcement/announcement-pt-br.md
@@ -1,6 +1,6 @@
 <ul>
   <li>
-    <p class="announcement-title">A documentação do Express 5.0 já está disponível.</p>
+    <p class="announcement-title">{% include icons/announcement.svg %} A documentação do Express 5.0 já está disponível.</p>
     <p markdown="1">
       <!-- we still haven't a 5x doc for pt-br -->
       A <a href="/5x/api.html">documentação da API</a> está em andamento. Para obter informações sobre o que há no lançamento, consulte o <a href="https://github.com/expressjs/express/blob/5.0/History.md">histórico de lançamentos</a> do Express.

diff --git a/_includes/announcement/announcement-th.md b/_includes/announcement/announcement-th.md
@@ -1,6 +1,6 @@
 <ul>
   <li>
-    <p class="announcement-title">Express รุ่น 4.16.0 มีคุณลักษณะความปลอดภัยล่าสุดที่สำคัญ</p>
+    <p class="announcement-title">{% include icons/announcement.svg %} Express รุ่น 4.16.0 มีคุณลักษณะความปลอดภัยล่าสุดที่สำคัญ</p>
     <p markdown="1">
      สำหรับข้อมูลว่าอะไรเพิ่มเติมบ้างในรุ่นนี้ สามารถดูใน [บันทึกการเปลี่ยนแปลง 4.16.0](/{{ page.lang }}/changelog/4x.html#4.16.0).
     </p>

diff --git a/_includes/announcement/announcement-tr.md b/_includes/announcement/announcement-tr.md
@@ -1,6 +1,6 @@
 <ul>
   <li>
-    <p class="announcement-title">Express 4.16.0 mevcut sürümdür.</p>
+    <p class="announcement-title">{% include icons/announcement.svg %} Express 4.16.0 mevcut sürümdür.</p>
     <p markdown="1">
 	Bu sürümde nelerin eklendiği hakkında daha fazla bilgi almak için [4.16.0 changelog](/{{ page.lang }}/changelog/4x.html#4.16.0).
     </p>

diff --git a/_includes/announcement/announcement-uz.md b/_includes/announcement/announcement-uz.md
@@ -1,6 +1,6 @@
 <ul>
   <li>
-    <p class="announcement-title">Express 4.16.0 reliz qilindi</p>
+    <p class="announcement-title">{% include icons/announcement.svg %} Express 4.16.0 reliz qilindi</p>
     <p markdown="1">
     Express 4.16.0 da ko'plab xatolar to'g'irlandi, xavfsizlikni ta'minlash uchun o'zgarishlar kiritildi, ishlash unumdorligi oshirildi va boshqa yangi imkoniyatlar qo'shildi. To'liq ma'lumot uchun [4.16.0 changelog](/en/changelog/4x.html#4.16.0).
     </p>

diff --git a/_includes/api/en/4x/res-end.md b/_includes/api/en/4x/res-end.md
@@ -1,6 +1,6 @@
-<h3 id='res.end'>res.end([data] [, encoding])</h3>
+<h3 id='res.end'>res.end([data[, encoding]][, callback])</h3>
 
-Ends the response process. This method actually comes from Node core, specifically the [response.end() method of  http.ServerResponse](https://nodejs.org/api/http.html#http_response_end_data_encoding_callback).
+Ends the response process. This method actually comes from Node core, specifically the [response.end() method of http.ServerResponse](https://nodejs.org/api/http.html#responseenddata-encoding-callback).
 
 Use to quickly end the response without any data. If you need to respond with data, instead use methods such as [res.send()](#res.send) and [res.json()](#res.json).
 

diff --git a/_includes/api/en/5x/res-end.md b/_includes/api/en/5x/res-end.md
@@ -1,6 +1,6 @@
-<h3 id='res.end'>res.end([data] [, encoding])</h3>
+<h3 id='res.end'>res.end([data[, encoding]][, callback])</h3>
 
-Ends the response process. This method actually comes from Node core, specifically the [response.end() method of  http.ServerResponse](https://nodejs.org/api/http.html#http_response_end_data_encoding_callback).
+Ends the response process. This method actually comes from Node core, specifically the [response.end() method of http.ServerResponse](https://nodejs.org/api/http.html#responseenddata-encoding-callback).
 
 Use to quickly end the response without any data. If you need to respond with data, instead use methods such as [res.send()](#res.send) and [res.json()](#res.json).
 

diff --git a/_includes/changelog/menu.md b/_includes/changelog/menu.md
@@ -0,0 +1,4 @@
+### Versions
+
+- [5.x](#5.x)
+- [4.x](#4.x)  
diff --git a/_includes/footer/footer-de.html b/_includes/footer/footer-de.html
@@ -1,4 +1,4 @@
-<a id="top" href="#"><img src="/images/arrow.png"></a>
+<a id="top" href="#">{% include icons/arrow.svg %}</a>
 
 <footer>
     <div id="footer-content">

diff --git a/_includes/footer/footer-en.html b/_includes/footer/footer-en.html
@@ -1,4 +1,4 @@
-<a id="top" href="#"><img src="/images/arrow.png"></a>
+<a id="top" href="#">{% include icons/arrow.svg %}</a>
 
 <footer>
   <section id="doc-langs">

diff --git a/_includes/footer/footer-es.html b/_includes/footer/footer-es.html
@@ -1,4 +1,4 @@
-<a id="top" href="#"><img src="/images/arrow.png"></a>
+<a id="top" href="#">{% include icons/arrow.svg %}</a>
 
 <footer>
   <section id="footer-content">

diff --git a/_includes/footer/footer-fr.html b/_includes/footer/footer-fr.html
@@ -1,4 +1,4 @@
-<a id="top" href="#"><img src="/images/arrow.png"></a>
+<a id="top" href="#">{% include icons/arrow.svg %}</a>
 
 <footer>
     <div id="footer-content">

diff --git a/_includes/footer/footer-id.html b/_includes/footer/footer-id.html
@@ -1,4 +1,4 @@
-<a id="top" href="#"><img src="/images/arrow.png"></a>
+<a id="top" href="#">{% include icons/arrow.svg %}</a>
 
 <footer>
   <section id="doc-langs">

diff --git a/_includes/footer/footer-it.html b/_includes/footer/footer-it.html
@@ -1,4 +1,4 @@
-<a id="top" href="#"><img src="/images/arrow.png"></a>
+<a id="top" href="#">{% include icons/arrow.svg %}</a>
 
 <footer>
     <section id="footer-content">

diff --git a/_includes/footer/footer-ja.html b/_includes/footer/footer-ja.html
@@ -1,4 +1,4 @@
-<a id="top" href="#"><img src="/images/arrow.png"></a>
+<a id="top" href="#">{% include icons/arrow.svg %}</a>
 
 <footer>
     <section id="footer-content">

diff --git a/_includes/footer/footer-ko.html b/_includes/footer/footer-ko.html
@@ -1,4 +1,4 @@
-<a id="top" href="#"><img src="/images/arrow.png"></a>
+<a id="top" href="#">{% include icons/arrow.svg %}</a>
 
 <footer>
     <section id="footer-content">

diff --git a/_includes/footer/footer-pt-br.html b/_includes/footer/footer-pt-br.html
@@ -1,4 +1,4 @@
-<a id="top" href="#"><img src="/images/arrow.png"></a>
+<a id="top" href="#">{% include icons/arrow.svg %}</a>
 
 <footer>
 

diff --git a/_includes/footer/footer-ru.html b/_includes/footer/footer-ru.html
@@ -1,4 +1,4 @@
-<a id="top" href="#"><img src="/images/arrow.png"></a>
+<a id="top" href="#">{% include icons/arrow.svg %}</a>
 
 <footer>
     <section id="footer-content">

diff --git a/_includes/footer/footer-sk.html b/_includes/footer/footer-sk.html
@@ -1,4 +1,4 @@
-<a id="top" href="#"><img src="/images/arrow.png"></a>
+<a id="top" href="#">{% include icons/arrow.svg %}</a>
 
 <footer>
     <section id="footer-content">

diff --git a/_includes/footer/footer-th.html b/_includes/footer/footer-th.html
@@ -1,4 +1,4 @@
-<a id="top" href="#"><img src="/images/arrow.png"></a>
+<a id="top" href="#">{% include icons/arrow.svg %}</a>
 
 <footer>
   <section id="footer-content">

diff --git a/_includes/footer/footer-tr.html b/_includes/footer/footer-tr.html
@@ -1,4 +1,4 @@
-<a id="top" href="#"><img src="/images/arrow.png"></a>
+<a id="top" href="#">{% include icons/arrow.svg %}</a>
 
 <footer>
   <section id="footer-content">

diff --git a/_includes/footer/footer-uk.html b/_includes/footer/footer-uk.html
@@ -1,4 +1,4 @@
-<a id="top" href="#"><img src="/images/arrow.png"></a>
+<a id="top" href="#">{% include icons/arrow.svg %}</a>
 
 <footer>
     <section id="footer-content">

diff --git a/_includes/footer/footer-uz.html b/_includes/footer/footer-uz.html
@@ -1,4 +1,4 @@
-<a id="top" href="#"><img src="/images/arrow.png"></a>
+<a id="top" href="#">{% include icons/arrow.svg %}</a>
 
 <footer>
     <section id="footer-content">

diff --git a/_includes/footer/footer-zh-cn.html b/_includes/footer/footer-zh-cn.html
@@ -1,4 +1,4 @@
-<a id="top" href="#"><img src="/images/arrow.png"></a>
+<a id="top" href="#">{% include icons/arrow.svg %}</a>
 
 <footer>
     <section id="footer-content">

diff --git a/_includes/footer/footer-zh-tw.html b/_includes/footer/footer-zh-tw.html
@@ -1,4 +1,4 @@
-<a id="top" href="#"><img src="/images/arrow.png"></a>
+<a id="top" href="#">{% include icons/arrow.svg %}</a>
 
 <footer>
     <section id="footer-content">

diff --git a/_includes/head.html b/_includes/head.html
@@ -42,10 +42,8 @@
     {% endif %}
 
     <script data-cfasync="false" src="//ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min.js"></script>
-    <script data-cfasync="false" src="/js/ismobile.js"></script>
     <script data-cfasync="false" src="/js/app.js"></script>
     <script data-cfasync="false" defer src="/js/menu.js"></script>
-    <script data-cfasync="false" src="/js/retina.js"></script>  
     <script data-cfasync="false" src="/js/prism.js"></script>
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
 

diff --git a/_includes/header/header-de.html b/_includes/header/header-de.html
@@ -104,6 +104,21 @@
                           </li>
                       </ul>
           </li>
+          <li><a href="/{{ page.lang }}/support" id="support-menu"{% if page.menu == 'support' %} class="active"{% endif %}>Support</a></li>
+          <li id="blog-menu" class="submenu">
+            <a href="{{site.posts.first.url}}"{% if page.menu == 'blog' %} class="active"{% endif %}>Blog</a>
+            <ul class="submenu-content">
+              <li>
+                <a href="{{site.posts.first.url}}">Latest post</a> 
+              </li>
+              <li>
+                <a href="/en/blog/posts.html">All posts</a> 
+              </li>                          
+              <li>
+                <a href="/en/blog/write-post.html">Write a Post</a>
+              </li>
+            </ul>
+          </li>
       </ul>
   </div>
   <div id="theme-icon-container" class="theme-toggle default-theme" title="toggle darkmode">

diff --git a/_includes/header/header-es.html b/_includes/header/header-es.html
@@ -105,6 +105,21 @@
                           </li>
                       </ul>
           </li>
+          <li><a href="/{{ page.lang }}/support" id="support-menu"{% if page.menu == 'support' %} class="active"{% endif %}>Support</a></li>
+          <li id="blog-menu" class="submenu">
+                  <a href="{{site.posts.first.url}}"{% if page.menu == 'blog' %} class="active"{% endif %}>Blog</a>
+                      <ul class="submenu-content">
+                          <li>
+                            <a href="{{site.posts.first.url}}">Latest post</a> 
+                          </li>
+                          <li>
+                            <a href="/en/blog/posts.html">All posts</a> 
+                          </li>                          
+                          <li>
+                      <a href="/en/blog/write-post.html">Write a Post</a>
+                  </li>
+              </ul>
+          </li>
       </ul>
   </div>
   <div id="theme-icon-container" class="theme-toggle default-theme" title="toggle darkmode">

diff --git a/_includes/header/header-fr.html b/_includes/header/header-fr.html
@@ -106,6 +106,21 @@
                           </li>
                       </ul>
           </li>
+          <li><a href="/{{ page.lang }}/support" id="support-menu"{% if page.menu == 'support' %} class="active"{% endif %}>Support</a></li>
+          <li id="blog-menu" class="submenu">
+                  <a href="{{site.posts.first.url}}"{% if page.menu == 'blog' %} class="active"{% endif %}>Blog</a>
+                      <ul class="submenu-content">
+                          <li>
+                            <a href="{{site.posts.first.url}}">Latest post</a> 
+                          </li>
+                          <li>
+                            <a href="/en/blog/posts.html">All posts</a> 
+                          </li>                          
+                          <li>
+                    <a href="/en/blog/write-post.html">Write a Post</a>
+                </li>
+              </ul>
+          </li>
       </ul>
   </div>
   <div id="theme-icon-container" class="theme-toggle default-theme" title="toggle darkmode">

diff --git a/_includes/header/header-id.html b/_includes/header/header-id.html
@@ -126,6 +126,24 @@
                             </li>
                         </ul>
             </li>
+
+            <li><a href="/{{ page.lang }}/support" id="support-menu"{% if page.menu == 'support' %} class="active"{% endif %}>Support</a></li>
+          <li id="blog-menu" class="submenu">
+                  <a href="{{site.posts.first.url}}"{% if page.menu == 'blog' %} class="active"{% endif %}>Blog</a>
+                      <ul class="submenu-content">
+                          <li>
+                            <a href="{{site.posts.first.url}}">Latest post</a> 
+                          </li>
+                          <li>
+                            <a href="/en/blog/posts.html">All posts</a> 
+                          </li>                          
+                          <li>
+                            <a href="/en/blog/write-post.html">Write a Post</a>
+                          </li>
+                      </ul>
+                  </li>
+          </li>
+
         </ul>
     </div>
     <div id="theme-icon-container" class="theme-toggle default-theme" title="toggle darkmode">

diff --git a/_includes/header/header-it.html b/_includes/header/header-it.html
@@ -102,6 +102,21 @@
                           </li>
                       </ul>
           </li>
+          <li><a href="/{{ page.lang }}/support" id="support-menu"{% if page.menu == 'support' %} class="active"{% endif %}>Support</a></li>
+          <li id="blog-menu" class="submenu">
+                  <a href="{{site.posts.first.url}}"{% if page.menu == 'blog' %} class="active"{% endif %}>Blog</a>
+                      <ul class="submenu-content">
+                          <li>
+                            <a href="{{site.posts.first.url}}">Latest post</a> 
+                          </li>
+                          <li>
+                            <a href="/en/blog/posts.html">All posts</a> 
+                          </li>                          
+                          <li>
+                            <a href="/en/blog/write-post.html">Write a Post</a>
+                          </li>
+                      </ul>
+                  </li>
       </ul>
   </div>
   <div id="theme-icon-container" class="theme-toggle default-theme" title="toggle darkmode">