Tworzenie treści portalu za pomocą edytora stron

Wyświetlasz dokumentację Apigee Edge.
Przejdź do dokumentacji Apigee X. info

Za pomocą edytora stron możesz definiować treści portalu w języku Markdown lub HTML.

Zapoznanie się z edytorem stron

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

Edytor stron

Jak widać na poprzednim rysunku, edytor stron umożliwia:

Edytowanie treści w edytorze stron

Markdown to prosty język formatowania, który używa znaczników w postaci zwykłego tekstu, które są łatwe do odczytania i napisania. Jego składnia jest określana za pomocą znaków interpunkcyjnych. Przed renderowaniem w przeglądarce Markdown jest konwertowany na HTML.

Pasek narzędzi szybkiej edycji u góry edytora stron 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 Markdown, kliknij Ikona Markdown na pasku narzędzi szybkiej edycji, aby wyświetlić krótkie omówienie składni Markdown.

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

Jeśli chcesz uprościć proces formatowania, zalecamy używanie języka Markdown. Nie ma on jednak zastępować języka HTML. W HTML możesz stosować wiele formatów, których nie można używać w Markdown. W HTML możesz na przykład określić klasę CSS dla elementu. Nie możesz tego zrobić w Markdown: 

   <p class="class1">

Możesz wstawić kod HTML w dowolnym miejscu treści, po prostu wpisując tagi HTML.

Informacje o tagach HTML znajdziesz w specyfikacji HTML5.

Dodawanie komponentów Angular Material

Angular Material to najnowocześniejsza biblioteka komponentów interfejsu. Komponenty Angular Material umożliwiają szybkie i łatwe tworzenie spójnych, responsywnych i dostępnych interfejsów użytkownika z wykorzystaniem nowoczesnych zasad projektowania.

Dostępne komponenty

Portal jest zbudowany przy użyciu Angular Material, a na stronach można używać ograniczonego zestawu komponentów Angular Material, które są podsumowane w tabeli poniżej.

Komponent Przykład
Buttons Ten kod tworzy prostokątny przycisk z cieniem.
<a mat-raised-button 
   href="quickstart">
   Quick Start
</a>

Ten kod tworzy okrągły przycisk z przezroczystym tłem, który zawiera ikonę ostrzeżenia. Kolor przycisku jest określony za pomocą palety kolorów ostrzeżenia.

<button mat-icon-button
   color="warn">
   <mat-icon aria-label="Example warning">warning</mat-icon>
</button>
Card Ten kod tworzy kartę. Karta zawiera komponenty przycisku i ikony, a także tekst nagłówka i treści. Kolor przycisku jest określony za pomocą palety kolorów podstawowych.
<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>
Icon Ten kod tworzy ikonę znacznika wyboru. Pełną listę obsługiwanych ikon znajdziesz w artykule Material Design – Icons.
<mat-icon>
   check_circle
</mat-icon>
Toolbar Ten kod tworzy prosty pasek narzędzi z tekstem i ikoną koszyka na zakupy. 
<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:

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

  1. Obok listy odbiorców w panelu po prawej stronie edytora stron kliknij Zarządzaj.
  2. Wybierz ustawienie widoczności. Jeśli masz dostęp do wersji beta funkcji list odbiorców, wybierz jedną z tych opcji:
    • Publiczne (widoczne dla każdego) , aby umożliwić wszystkim użytkownikom wyświetlanie strony.
    • Uwierzytelnieni użytkownicy , aby umożliwić wyświetlanie strony tylko zarejestrowanym użytkownikom.
    • Wybrane listy odbiorców , aby wybrać konkretne listy odbiorców, które mają mieć możliwość wyświetlania strony. Więcej informacji znajdziesz w artykule Zarządzanie listami odbiorców 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 umożliwić wszystkim użytkownikom wyświetlanie strony.
    • Zarejestrowani użytkownicy , aby umożliwić wyświetlanie strony tylko zarejestrowanym użytkownikom.
  3. Kliknij Zastosuj.

Wyświetlanie podglądu treści portalu

Aby wyświetlić podgląd treści portalu, na pasku narzędzi edytora stron kliknij Podgląd. W razie potrzeby przejdź do innych stron w portalu, aby wyświetlić podgląd treści.

Publikowanie treści 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, w panelu po prawej stronie edytora stron kliknij Usuń. Zostanie wyświetlona prośba o potwierdzenie operacji.