Phát triển nội dung cổng thông qua trình chỉnh sửa trang

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. thông tin

Khi sử dụng trình chỉnh sửa trang, bạn xác định nội dung cổng thông tin bằng Markdown hoặc HTML.

Khám phá trình chỉnh sửa trang

Truy cập vào trình chỉnh sửa trang bằng cách nhấp vào tên của một trang khi xem danh sách trang, như mô tả trong phần Quản lý các trang trong cổng thông tin.

Như được làm nổi bật trong hình trước, trình chỉnh sửa trang cho phép bạn:

• Chỉnh sửa nội dung trên cổng thông tin và thêm các thành phần Angular Material vào ngăn bên trái
• Sử dụng thanh công cụ chỉnh sửa nhanh để áp dụng định dạng hoặc chèn thẻ đánh dấu một cách nhanh chóng
• Chỉnh sửa thông tin chi tiết về trang (chẳng hạn như tên, đường dẫn và nội dung mô tả) trong ngăn bên phải
• Quản lý khả năng hiển thị cho một trang trong ngăn bên phải
• Xem trước nội dung trên cổng thông tin
• Xuất bản hoặc huỷ xuất bản một trang (xem phần Xuất bản nội dung trên cổng thông tin)
• Quản lý trang trong trình đơn điều hướng (xem phần Thiết lập trình đơn điều hướng)
• Xem khoảng thời gian kể từ lần xuất bản gần đây nhất của trang
• Xoá trang

Chỉnh sửa nội dung trong trình chỉnh sửa trang

Markdown là một ngôn ngữ định dạng đơn giản sử dụng mã đánh dấu văn bản thuần tuý, vừa dễ đọc vừa dễ viết. Cú pháp của nó được chỉ định bằng các ký tự dấu câu. Markdown được chuyển đổi thành HTML trước khi hiển thị trong trình duyệt của bạn.

Thanh công cụ chỉnh sửa nhanh ở đầu trình chỉnh sửa trang cung cấp các phím tắt để áp dụng định dạng (chẳng hạn như in đậm, in nghiêng, v.v.) hoặc chèn thẻ Markdown (chẳng hạn như danh sách, hình ảnh, đường liên kết, v.v.). Để xem bản tóm tắt nhanh về cú pháp Markdown, hãy nhấp vào biểu tượng trên thanh công cụ chỉnh sửa nhanh để xem bảng tham chiếu nhanh về cú pháp Markdown.

Để huỷ hoặc làm lại thao tác chỉnh sửa gần đây nhất, hãy nhấp vào Command-z hoặc Command-Shift-z.

Bạn nên sử dụng Markdown nếu muốn quy trình định dạng đơn giản. Tuy nhiên, CSS không nhằm mục đích thay thế HTML. Có nhiều định dạng mà bạn có thể sử dụng trong HTML nhưng không thể sử dụng trong Markdown. Ví dụ: bạn có thể chỉ định một lớp CSS cho một phần tử trong HTML; bạn không thể làm việc này trong Markdown:

   <p class="class1">

Bạn có thể chèn HTML vào bất kỳ vị trí nào trong phần nội dung bằng cách chỉ cần nhập thẻ HTML.

Để biết thông tin về thẻ HTML, hãy xem quy cách HTML5.

Thêm các thành phần Angular Material

Angular Material cung cấp một thư viện thành phần giao diện người dùng hiện đại. Các thành phần Angular Material giúp bạn nhanh chóng và dễ dàng tạo giao diện người dùng nhất quán, thích ứng và dễ sử dụng bằng cách áp dụng các nguyên tắc thiết kế hiện đại.

Các thành phần có sẵn

Trải nghiệm trên cổng thông tin được xây dựng bằng Angular Material và bạn có thể dùng một số thành phần Angular Material trong các trang, được tóm tắt trong bảng sau.

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

Quản lý chế độ hiển thị của một trang trong cổng thông tin

Quản lý khả năng hiển thị của một trang trong cổng thông tin bằng cách cho phép truy cập vào:

• Công khai (mọi người đều nhìn thấy)
• Người dùng đã xác thực
• Đối tượng được chọn (nếu bạn đã đăng ký tham gia bản phát hành thử nghiệm của tính năng đối tượng)

Cách quản lý chế độ hiển thị của một trang trong cổng thông tin:

1. Nhấp vào Quản lý bên cạnh đối tượng trong ngăn bên phải của trình chỉnh sửa trang.
2. Chọn chế độ hiển thị. Nếu bạn đã đăng ký tham gia bản phát hành thử nghiệm của tính năng đối tượng, hãy chọn một trong các lựa chọn sau:
   • Công khai (mọi người đều có thể xem) để cho phép tất cả người dùng xem trang này.
   • Người dùng đã xác thực để chỉ cho phép người dùng đã đăng ký xem trang.
   • Đối tượng được chọn để chọn những đối tượng cụ thể mà bạn muốn cho phép xem trang. Xem phần Quản lý đối tượng cho cổng thông tin.
     Để quản lý đối tượng, hãy nhấp vào Tạo hoặc sửa đổi đối tượng.
   
   Nếu không, hãy chọn một trong các lựa chọn sau:
   • Người dùng ẩn danh để cho phép tất cả người dùng xem trang.
   • Người dùng đã đăng ký để chỉ cho phép người dùng đã đăng ký xem trang.
3. Nhấp vào Áp dụng.

Xem trước nội dung trên cổng

Để xem trước nội dung trên cổng thông tin, hãy nhấp vào Xem trước trong thanh công cụ của trình chỉnh sửa trang. Chuyển đến các trang khác trong cổng thông tin để xem trước nội dung nếu muốn.

Xuất bản nội dung trên cổng thông tin

Để xuất bản nội dung trên cổng thông tin, hãy nhấp vào Xuất bản trong ngăn bên phải. Để huỷ xuất bản nội dung trên cổng thông tin, hãy nhấp vào Huỷ xuất bản trong ngăn bên phải. Xem thêm phần Xuất bản nội dung trên cổng thông tin.

Xoá trang

Để xoá một trang khỏi trình chỉnh sửa cổng thông tin, hãy nhấp vào Xoá trong ngăn bên phải của trình chỉnh sửa trang. Bạn sẽ được nhắc xác nhận thao tác.