Snapshot của whatwg/url: 634★ · HTML. URL Standard
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
This repository hosts the URL Standard. It is one of many web standards developed by the WHATWG community.
Code of conduct
We are committed to providing a friendly, safe, and welcoming environment for all. Please read and respect the Code of Conduct.
Contribution opportunities
Folks notice minor and larger issues with the URL Standard all the time and we'd love your help fixing those. Pull requests for typographical and grammar errors are also most welcome.
Issues labeled "good first issue" are a good place to get a taste for editing the URL Standard. Note that we don't assign issues and there's no reason to ask for availability either, just provide a pull request.
If you are thinking of suggesting a new feature, read through the FAQ and Working Mode documents to get yourself familiarized with the process.
We'd be happy to help you with all of this on Chat.
Pull requests
In short, change url.bs and submit your patch, with a good commit message.
Please add your name to the Acknowledgments section in your first pull request, even for trivial fixes. The names are sorted lexicographically.
To ensure your patch meets all the necessary requirements, please also see the Contributor Guidelines. Editors of the URL Standard are expected to follow the Maintainer Guidelines.
Tests
Tests are an essential part of the standardization process and will need to be created or adjusted as changes to the standard are made. Tests for the URL Standard can be found in the url/ directory of web-platform-tests/wpt.
A dashboard showing the tests running against browser engines can be seen at wpt.fyi/results/url.
Building "locally"
For quick local iteration, run make; this will use a web service to build the standard, so that you don't have to install anything. See more in the Contributor Guidelines.
Formatting
Use a column width of 100 characters.
Do not use newlines inside "inline" elements, even if that means exceeding the column width requirement.
<p>The
<dfn method for=DOMTokenList lt=remove(tokens)|remove()><code>remove(<var>tokens</var>…)</code></dfn>
method, when invoked, must run these steps:
is okay and
<p>The <dfn method for=DOMTokenList
lt=remove(tokens)|remove()><code>remove(<var>tokens</var>…)</code></dfn> method, when
invoked, must run these steps:
is not.
Using newlines between "inline" element tag names and their content is also forbidden. (This actually alters the content, by adding spaces.) That is
<a>token</a>
is fine and
<a>token
</a>
is not.
An <li> element always has a <p> element inside it, unless it's a child of <ul class=brief>.
If a "block" element contains a single "block" element, do not put it on a newline.
Do not indent for anything except a new "block" element. For instance
<li><p>For each <var>token</var> in <var>tokens</var>, in given order, that is not in
<a>tokens</a>, append <var>token</var> to <a>tokens</a>.
is not indented, but
<ol>
<li>
<p>For each <var>token</var> in <var>tokens</var>, run these substeps:
<ol>
<li><p>If <var>token</var> is the empty string, <a>throw</a> a {{SyntaxError}} exception.
is.
End tags may be included (if done consistently) and attributes may be quoted (using double quotes), though the prevalent theme is to omit end tags and not quote attributes (unless they contain a space).
Place one newline between paragraphs (including list elements). Place three newlines before <h2>, and two newlines before other headings. This does not apply when a nested heading follows the parent heading.
<ul>
<li><p>Do not place a newline above.
<li><p>Place a newline above.
</ul>
<p>Place a newline above.
<h3>Place two newlines above.</h3>
<h4>Placing one newline is OK here.</h4>
<h4>Place two newlines above.</h4>
Use camel-case for variable names and "spaced" names for definitions, algorithms, etc.
<p>A <a for=/>request</a> has an associated
<dfn export for=request id=concept-request-redirect-mode>redirect mode</dfn>,...
<p>Let <var>redirectMode</var> be <var>request</var>'s <a for=request>redirect mode</a>.
Implementations
A complete JavaScript implementation of the standard can be found at
jsdom/whatwg-url. This implementation is kept synchronized
with the standard and tests.
A complete C++ implementation of the standard can be found at
ada-url/ada. This implementation is kept synchronized
with the standard and tests, and is currently used in Node.js.
A complete Python implementation of the standard can be found at
pywhatwgurl/pywhatwgurl. This implementation is kept
synchronized with the standard and tests.
The Live URL Viewer lets you manually test-parse any URL,
comparing your browser's URL parser to that of
jsdom/whatwg-url.
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/whatwg/url là nguồn chính thức.
whatwg/url có phải mã nguồn mở không?
TopGit chưa ghi nhận license cho whatwg/url. Phần lớn repo public trên GitHub là mã nguồn mở, nhưng điều khoản khác nhau từng repo — mở file LICENSE để xác nhận.
whatwg/url có trang demo không?
Dự án có trang chủ ở https://url.spec.whatwg.org/. Tab "Readme" ở trang này thường có ảnh chụp và hướng dẫn bắt đầu nhanh.
whatwg/url là gì?
whatwg/url (whatwg/url) là dự án HTML trên GitHub. Theo mô tả gốc: URL Standard
Đọc đầy đủ README ở tab phía trên.
Chưa chắc url có hợp với bạn?
Để ChatGPT, Claude hoặc Perplexity tìm hiểu giúp — bấm bên dưới và xem AI nói gì về url.