Konwerter encji HTML

Konwerter encji HTML to bezpłatne narzędzie, które przekształca odwołania znakowe HTML w zwykłe znaki i odwrotnie. Wyniki możesz wykorzystać na stronach internetowych, w systemach zarządzania treścią oraz innych formatach tekstowych.

Czym są encje HTML i do czego służą?

Encje HTML pozwalają zapisywać znaki w postaci tekstu, który HTML potrafi odróżnić od własnych znaczników. Odwołanie znakowe HTML zwykle zaczyna się od znaku ampersand i kończy średnikiem. Może być odwołaniem nazwanym, takim jak & oznaczające ampersand, albo numerycznym, na przykład £ oznaczające symbol funta.

Takie odwołania przydają się, gdy znak ma specjalne znaczenie w HTML. Dosłowny znak mniejszości mógłby zostać uznany za początek znacznika, dlatego można go zapisać jako <. Odwołania znakowe umożliwiają też przedstawianie określonych znaków w HTML lub zgodnych z nim językach znaczników bez ryzyka pomylenia ich ze znacznikami albo składnią sterującą.

Kodowanie encji nie jest szyfrowaniem i nie zapewnia poufności. Każdy może odczytać lub zdekodować takie odwołanie, dlatego nigdy nie używaj go do ukrywania haseł, danych osobowych ani poufnych treści.

Jak używać konwertera encji HTML?

Wpisz odpowiedni tekst w polu Zakoduj lub Dekoduj, a następnie odczytaj odpowiadający mu wynik Zakodowane encje HTML albo Zdekodowane encje HTML. Użyj zakodowanego wyniku, jeśli tekst ma trafić do odpowiedniego kontekstu tekstowego lub atrybutu HTML. Wynik zdekodowany wybierz wtedy, gdy potrzebujesz znaków reprezentowanych przez istniejące encje.

Konwersja odbywa się na serwerze. Wprowadzone dane są przesyłane do niego przez HTTPS i nie są przechowywane.

Przed konwersją sprawdź, czy rzeczywiście potrzebujesz encji HTML. Wartość w ciągu zapytania zwykle wymaga kodowania procentowego URL, natomiast domena umiędzynarodowiona korzysta z Punycode. Do tych formatów służą odpowiednio Dekoder URL i Konwerter IDN Punycode.

Jak wygląda wynik kodowania lub dekodowania?

Podczas dekodowania rozpoznane odwołania do encji są zastępowane reprezentowanymi przez nie znakami. Kodowanie wykonuje operację odwrotną i zapisuje znaki przy użyciu składni encji.

Dane wejściowe: <p>Tea & cake</p>

Wynik dekodowania: <p>Tea & cake</p>

Nawiasy ostre w zdekodowanym wyniku są znakami, które po wstawieniu na stronę jako HTML mogą stać się znacznikami. Dekodowanie nie oczyszcza treści, nie usuwa skryptów ani nie sprawia, że niezaufany kod HTML staje się bezpieczny. Ze zdekodowanym materiałem postępuj odpowiednio do kontekstu, w którym zostanie użyty.

Przykłady i kłopotliwe dane wejściowe

Encje nazwane i numeryczne odwołania znakowe mogą przedstawiać ten sam znak na różne sposoby. Na przykład &amp; jest nazwanym odwołaniem oznaczającym ampersand, &#38; to jego dziesiętne odwołanie numeryczne, a &#x26; jest zapisem szesnastkowym.

• Zwykłe spacje i liczby zapisane bezpośrednio nie są odwołaniami do encji i zazwyczaj pozostają zwykłym tekstem.
• Znaki interpunkcyjne zmieniają się tylko wtedy, gdy występują jako rozpoznane odwołania do encji albo zostaną celowo zakodowane.
• Litery ze znakami diakrytycznymi, tekst zapisany alfabetem innym niż łaciński oraz emoji można przedstawiać za pomocą numerycznych odwołań znakowych. Wskazują one punkty kodowe Unicode niezależnie od kodowania źródła HTML. Prawidłowe wyświetlanie zależy od obsługi znaków przez czcionkę, natomiast kodowanie znaków ma znaczenie, gdy zdekodowany wynik jest przechowywany lub przesyłany.

Podczas przygotowywania encji dodawaj średnik na końcu. Przeglądarki w niektórych kontekstach tolerują część odwołań bez średnika, ale taki skrócony zapis może być niejednoznaczny i jest mniej przenośny między parserami.

Gdzie spotyka się encje HTML?

Encje HTML często występują w kodzie źródłowym HTML, systemach zarządzania treścią, edytorach tekstu sformatowanego i wiadomościach e-mail w formacie HTML. Na przykład w widoku kodu WordPressa możesz zobaczyć &nbsp; oznaczające spację nierozdzielającą albo &amp; w miejscu, w którym ampersand musi zostać zachowany w znacznikach.

Encje mogą również pojawiać się w danych przesyłanych wewnątrz innego formatu. Powstaje wtedy kilka warstw kodowania, które trzeba obsłużyć we właściwej kolejności.

• Dane JSON mogą zawierać fragment HTML, którego tekst obejmuje encje. Stosowanie sekwencji ucieczki JSON i dekodowanie encji HTML to osobne operacje.
• Ciąg zapytania może zawierać kod HTML zakodowany procentowo. Najpierw zdekoduj warstwę URL, a dopiero potem sprawdź, czy uzyskany tekst również zawiera encje.
• Identyfikator URI danych może zawierać HTML lub inny tekst z encjami, chociaż sam URI może korzystać z kodowania procentowego albo Base64.
• Wiadomość e-mail w formacie HTML może kodować widoczne znaki interpunkcyjne, a jednocześnie używać kodowania transferowego MIME do przesyłania danych.
• Domena umiędzynarodowiona może występować obok kodu HTML z zakodowanymi encjami, ale sama domena jest zazwyczaj zapisywana przy użyciu Punycode, a nie encji HTML.

Dlaczego dekodowanie encji HTML nie działa lub daje niezrozumiały wynik?

Dekodowanie zwykle nie działa dlatego, że dane wejściowe są nieprawidłowe, korzystają z innego sposobu kodowania albo zawierają więcej niż jedną warstwę kodowania. Sprawdź, czy oryginalny tekst zawiera nazwane lub numeryczne odwołania znakowe HTML, zamiast wielokrotnie wykonywać konwersję bez kontrolowania wyniku.

• Nieprawidłowe odwołanie: Brak ampersandu, znaku numeru lub średnika może uniemożliwić rozpoznanie odwołania. Porównaj zapis z formami takimi jak &amp; lub &#38;.
• Podwójnie zakodowane dane: Tekst taki jak &amp;lt; po jednym dekodowaniu może zmienić się w &lt;. Aby otrzymać znak mniejszości, trzeba świadomie zdekodować go ponownie.
• Niezgodny zestaw znaków: Tekst zinterpretowany przy użyciu niewłaściwego kodowania znaków może zawierać symbole zastępcze lub uszkodzone litery ze znakami diakrytycznymi.
• Niewłaściwy format: Tekst zawierający znaki procenta może być zakodowany jako URL. Długi ciąg złożony z liter, cyfr, znaków plus, ukośników lub znaków równości na końcu może być zakodowany w Base64.
• Jeśli dane są zapisane w Base64, niewłaściwy wariant lub alfabet: Base64 bezpieczny dla adresów URL używa innych znaków niż standardowy Base64. Brak dopełnienia może też powodować błędy w niektórych dekoderach. Problemy te nie dotyczą składni encji HTML i wymagają użycia narzędzia Dekoder Base64.

Najczęstsze pytania

Dlaczego &nbsp; wygląda jak zwykła spacja?

&nbsp; oznacza spację nierozdzielającą. Zwykle wygląda ona jak normalna spacja, ale zapobiega podziałowi wiersza w tym miejscu. Edytory mogą zachowywać ją w sposób niewidoczny, dlatego podczas sprawdzania odstępów przejdź do widoku źródła lub wyświetl ukryte znaki.

Czy w nazwach encji HTML wielkość liter ma znaczenie?

Tak. Nazwane odwołania znakowe mają ściśle określoną pisownię, a wielkość liter może zdecydować o tym, czy odwołanie zostanie rozpoznane. Używaj dokładnej, opublikowanej nazwy i dodawaj średnik, zamiast polegać na automatycznym korygowaniu błędów przez przeglądarkę.

Czy każdą literę ze znakiem diakrytycznym trzeba zapisywać jako encję?

Nie. Dokument HTML z prawidłowo zadeklarowanym kodowaniem UTF-8 może bezpośrednio zawierać znaki takie jak é, £ i 中文. Encje nadal są przydatne, gdy wymagają ich składnia znaczników, starszy system lub konkretna reguła publikowania treści.

Czy encji HTML można używać w XML?

W XML wstępnie zdefiniowano tylko niewielki zestaw encji nazwanych, w tym &amp;, &lt;, &gt;, &quot; i &apos;. Wiele nazw prawidłowych w HTML jest nieprawidłowych w XML, chyba że zdefiniuje je typ dokumentu. Z tego powodu numeryczne odwołania znakowe są często bezpieczniejszym wyborem.

Czy konwerter encji naprawi uszkodzony kod HTML?

Nie. Może przekształcać odwołania do encji, ale nie domyka znaczników, nie poprawia ich zagnieżdżenia ani nie sprawdza poprawności dokumentu. Po konwersji przejrzyj otaczające znaczniki. Jeśli strona nadal działa nieprawidłowo, użyj walidatora HTML.

Końcowe sprawdzenie

Upewnij się, czy źródło korzysta z nazwanych, czy numerycznych odwołań znakowych HTML. Przekształć tylko wymaganą warstwę odwołań i porównaj wynik z tekstem, który ma być widoczny. Zanim umieścisz zdekodowaną treść na działającej stronie, sprawdź wszystkie powstałe nawiasy ostre, cudzysłowy i ampersandy w ich rzeczywistym kontekście HTML.