Tworzenie treści portalu za pomocą edytora stron

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje

Za pomocą edytora stron zdefiniuj zawartość portalu za pomocą języka Markdown lub HTML.

Poznaj edytor stron

Aby otworzyć edytor stron, kliknij nazwę strony podczas wyświetlania listy stron zgodnie z opisem w artykule Zarządzanie stronami w portalu.

Jak już wspomnieliśmy na poprzedniej ilustracji, edytor stron umożliwia:

• W panelu po lewej stronie edytuj zawartość portalu i dodaj komponenty Angular Material.
• Pasek narzędzi szybkiej edycji pozwala stosować formaty i szybko wstawiać tagi Markdown
• Edytowanie szczegółów strony, takich jak nazwa, ścieżka i opis, w panelu po prawej stronie
• Zarządzaj widocznością strony w panelu po prawej stronie
• Wyświetlanie podglądu zawartości portalu
• Publikowanie strony i cofanie jej publikacji (patrz Publikowanie treści portalu)
• Zarządzanie stroną w menu nawigacyjnym (patrz Konfigurowanie nawigacji)
• Wyświetlanie czasu, który upłynął od ostatniej publikacji strony
• Usuwanie strony

Edytowanie treści w edytorze stron

Markdown to prosty język formatowania wykorzystujący znaczniki zwykłego tekstu, który jest łatwy do odczytania i napisania. Jej składnię określa się przy użyciu znaków interpunkcyjnych. Format Markdown jest konwertowany do formatu HTML przed wyrenderowaniem w przeglądarce.

Pasek narzędzi szybkiej edycji u góry edytora strony zawiera skróty do stosowania formatów (np. pogrubienia, kursywy itp.) lub wstawiania tagów Markdown (np. list, obrazów, linków itp.). Aby zobaczyć krótkie podsumowanie składni języka Markdown, kliknij na pasku narzędzi szybkiej edycji, aby wyświetlić Krótkie omówienie składni znaczników.

Aby cofnąć lub ponowić ostatnią zmianę, kliknij odpowiednio Command-z lub Command-Shift-z.

Jest on zalecany, jeśli chcesz, aby formatowanie było proste. Nie ma jednak na celu zastąpienia kodu HTML. W kodzie HTML dostępnych jest szeroki zakres formatowania, których nie można stosować w Markdownie. Możesz na przykład określić klasę CSS elementu w kodzie HTML; nie można tego zrobić w Markdown:

   <p class="class1">

Kod HTML można wstawić w dowolnym miejscu w treści treści, wprowadzając po prostu tagi HTML.

Więcej informacji o tagach HTML znajdziesz w specyfikacji HTML5.

Dodawanie komponentów Angular Material

Angular Material udostępnia bibliotekę komponentów interfejsu o najnowocześniejszej technologii. Komponenty Angular Material pozwalają szybko tworzyć spójne, elastyczne i przystępne interfejsy użytkownika zgodne z nowoczesnymi zasadami projektowania.

Dostępne komponenty

Środowisko portalu zostało utworzone przy użyciu Angular Material. Na stronach można używać ograniczonego zestawu komponentów Angular Material, którego podsumowanie znajdziesz w poniższej tabeli.

<a mat-raised-button 
   href="quickstart">
   Quick Start
</a>

<button mat-icon-button
   color="warn">
   <mat-icon aria-label="Example warning">warning</mat-icon>
</button>

<mat-card 
   href="apis">
   <mat-card-header 
      color="primary">
         <mat-icon>
            class
         </mat-icon>
         <h1>
            APIs
         </h1>
   </mat-card-header>
   <mat-card-content>
      <p class="home-page-card-content-text">
         Learn about and try our APIs.
      </p>
   </mat-card-content>
   <mat-card-actions>
      <button mat-button>
          View APIs
      </button>
   </mat-card-actions>
</mat-card>

<mat-icon>
   check_circle
</mat-icon>

<mat-toolbar color="primary">
   <span>My Store</span>
   <span class="space-buffer"></span>
   <mat-icon>add_shopping</mat-icon>
</mat-toolbar>

Zarządzanie widocznością strony w portalu

Zarządzaj widocznością strony w portalu, zezwalając na dostęp do:

• Publiczny (widoczny dla każdego)
• Uwierzytelnieni użytkownicy
• Wybrani odbiorcy (jeśli zarejestrujesz się w wersji beta funkcji odbiorców)

Aby zarządzać widocznością strony w portalu:

1. W prawym panelu edytora stron obok listy odbiorców kliknij Zarządzaj.
2. Wybierz ustawienie widoczności. Jeśli zarejestrujesz się w wersji beta funkcji odbiorców, wybierz jedną z tych opcji:
   • Publiczna (widoczna dla każdego), aby wszyscy użytkownicy mogli wyświetlać stronę.
   • Uwierzytelnieni użytkownicy, aby zezwolić na wyświetlanie strony tylko zarejestrowanym użytkownikom.
   • Wybrani odbiorcy, aby wskazać konkretnych odbiorców, którzy będą mogli wyświetlać stronę. Przeczytaj artykuł Zarządzanie odbiorcami w portalu.
     Aby zarządzać listami odbiorców, kliknij Utwórz lub zmodyfikuj listy odbiorców.
   
   W przeciwnym razie wybierz jedną z tych opcji:
   • Anonimowi użytkownicy, aby zezwolić wszystkim użytkownikom na wyświetlanie strony.
   • Zarejestrowani użytkownicy, aby zezwolić na wyświetlanie strony tylko zarejestrowanych użytkownikom.
3. Kliknij Zastosuj.

Podgląd treści portalu

Aby wyświetlić podgląd zawartości portalu, kliknij Podgląd na pasku narzędzi edytora stron. Przejrzyj inne strony w portalu, aby wyświetlić podgląd treści.

Publikowanie treści w portalu

Aby opublikować treść portalu, w panelu po prawej stronie kliknij Opublikuj. Aby cofnąć publikację treści portalu, w panelu po prawej stronie kliknij Cofnij publikację. Zobacz też Publikowanie treści portalu.

Usuwanie strony

Aby usunąć stronę z edytora portalu, kliknij Usuń w prawym panelu edytora stron. Pojawi się prośba o potwierdzenie operacji.