Tworzenie treści portalu za pomocą edytora stron

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info

Zawartość portalu definiuje się w edytorze stron w formacie Markdown lub HTML.

Poznawanie edytora stron

Aby otworzyć edytor strony, kliknij jej nazwę na liście stron, tak jak opisano to w sekcji Zarządzanie stronami w portalu.

Jak zaznaczyliśmy na poprzednim rysunku, edytor stron umożliwia:

• edytować zawartość portalu i dodawać komponenty Angular Material w lewym panelu;
• Używaj paska narzędzi szybkiej edycji, aby szybko stosować formatowanie lub wstawiać tagi Markdown
• w panelu po prawej stronie edytuj szczegóły strony, takie jak nazwa, ścieżka i opis;
• Zarządzaj widocznością strony w panelu po prawej stronie
• Podgląd treści portalu
• publikować i cofać publikację strony (patrz Publikowanie treści w portalu).
• Zarządzaj stroną w menu nawigacyjnych (patrz Konfigurowanie nawigacji).
• Wyświetlanie czasu, jaki upłynął od ostatniej publikacji strony
• Usuwanie strony

Edytowanie treści w edytorze strony

Markdown to prosty język formatowania, który wykorzystuje znaczniki w zwykłym tekście, które są łatwe do odczytania i napisania. Składnia jest określana za pomocą znaków interpunkcyjnych. Format Markdown jest konwertowany na 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.). Jeśli chcesz zobaczyć krótkie podsumowanie składni języka Markdown, kliknij na pasku narzędzi szybkiej edycji, aby zobaczyć Krótkie omówienie składni znaczników.

Aby cofnąć lub ponowić ostatnią zmianę, kliknij Command+Z lub Command+Shift+Z.

Jeśli chcesz zachować prostotę procesu formatowania, zalecamy format Markdown. Nie zastępuje jednak kodu HTML. W HTML możesz zastosować wiele formatów, których nie ma w Markdown. Możesz na przykład określić klasę CSS dla elementu w kodzie HTML, czego nie można zrobić w Markdown:

   <p class="class1">

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

Informacje o tagach HTML znajdziesz w specyfikacji HTML5.

Dodaj komponenty materiałowe Angular

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 na podstawie Angular Material. Na stronach można używać ograniczonego zestawu komponentów Angular Material, który jest podsumowany w tabeli poniżej.

<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:

• Publiczna (widoczna dla każdego)
• Uwierzytelnieni użytkownicy
• wybrane listy odbiorców (jeśli uczestniczysz w testach beta funkcji list odbiorców);

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

1. Kliknij Zarządzaj obok listy odbiorców w panelu po prawej stronie edytora stron.
2. Wybierz ustawienie widoczności. Jeśli uczestniczysz w testach beta funkcji list odbiorców, wybierz jedną z tych opcji:
   • Publiczna (widoczna dla wszystkich), aby umożliwić wszystkim użytkownikom wyświetlanie strony.
   • Uwierzytelnieni użytkownicy, aby umożliwić wyświetlanie strony tylko zarejestrowanym użytkownikom.
   • Wybrani odbiorcy, aby wskazać konkretnych odbiorców, którym chcesz wyświetlać daną stronę. Zapoznaj się z artykułem Zarządzanie odbiorcami w portalu.
     Aby zarządzać odbiorcami, kliknij Tworzenie i modyfikowanie list 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 zezwolić na wyświetlanie strony tylko zarejestrowanym użytkownikom.
3. Kliknij Zastosuj.

Podgląd treści portalu

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

Publikowanie treści w portalu

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

Usuwanie strony

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