Instrukcja tworzenia odnośników do artykułów pomocy

Są dwa sposoby tworzenia odnośników do artykułów pomocy. Użycie metody jest uzależnione od tego, skąd i dokąd odnośnik wykonuje przekierowanie. Jeśli masz to być przekierowanie wewnętrzne z Firefoksa lub Firefoksa dla Androida można użyć metody „in-product”. Jeśli przekierowanie ma być z sieci Internet, należy w adresie nie umieszczać części wskazującej na lokalizację. Poniżej opisujemy, jak to działa.

Tworzenie odnośników „in-product” do SUMO

Przekierowania wewnętrzne powinny wyglądać następująco:

https://support.mozilla.org/1/firefox/%VERSION%/%OS%/%LOCALE%/TOPIC

Przykłady:

• https://support.mozilla.org/1/firefox/13.0a2/Darwin/en-US/prefs-privacy
• https://support.mozilla.org/1/firefox/13.0a2/Darwin/en-US/36eol

Ostatnia część adresu URL, temat, może być dowolnym ciągiem znaków.

By produkt był rozpoznawany, odnośniki do Firefoksa dla Androida powinny zawierać /1/mobile.

Struktura danych (produkt, wersja, system, lokalizacja, temat) określa, gdzie użytkownik zostanie przeniesiony. Umożliwia to zespołowi SUMO zmieniać obiekt docelowy bez, zachowując poprawność składni. Nasze artykuły zawierają specjalne znaczniki umożliwiające skierowanie, np. użytkowników systemu Mac OSX lub Windows do konkretnych, przeznaczonych dla danego systemu operacyjnego artykułów lub wersji programu itp.

Odnośniki do SUMO z internetu

Jeśli treść jest serwowana za pośrednictwem internetu i nie jest dostarczana z przeglądarką, nie ma potrzeby i nie powinno się używać przekierowań „in-product”.

Wszystko, co należy zrobić to użyć adresu URL bez ciągu znaków określających lokalizację. SUMO automatycznie przeniesie użytkownika do artykułu – jeśli jest – w jego wersji językowej.

Na przykład, aby przekierować do artykułu Aktualizacja Firefoksa, należy użyć takiego odnośnika:

• https://support.mozilla.org/kb/update-firefox-latest-version

Nie należy używać:

• https://support.mozilla.org/en-US/kb/update-firefox-latest-version

Tworzenie odnośników z dowolnego miejsca

Jeśli nie tworzysz odnośników z Firefoksa, Thunderbirda lub strony internetowej, tworzysz np. z jakiegoś programu, produktu, wiadomości e-mail itp., należy użyć adresu URL (bez lokalizacji) i dodać ciąg znaków identyfikujący źródło.

Przykład:

• https://support.mozilla.org/kb/update-firefox-latest-version?utm_source=nazwaźródła

Pytania, wątpliwości

Jeśli masz pytania lub potrzebujesz określić końcowy cel odnośnika „in-product”, wyślij e-maila do Michaela Verdiego – mverdi at mozilla.com lub skontaktuj się z nim na IRC-u, gdzie używa nicka verdi.