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.
Chuyển đến tài liệu về Apigee X. thông tin

Khi sử dụng trình chỉnh sửa trang, bạn có thể 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ư đã nêu trong hình trước, trình chỉnh sửa trang cho phép bạn:

• Chỉnh sửa nội dung cổng thông tin và thêm các thành phần Angular Material trong ngăn bên trái
• Dùng thanh công cụ chỉnh sửa nhanh để áp dụng các định dạng hoặc chèn nhanh thẻ Markdown
• 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ý chế độ hiển thị của một trang trong ngăn bên phải
• Xem trước nội dung cổng thông tin
• Xuất bản hoặc huỷ xuất bản trang (xem phần Xuất bản nội dung cổng thông tin)
• Quản lý trang trong trình đơn điều hướng (xem phần Thiết lập đ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 hàm này được chỉ định bằng cách sử dụng các ký tự dấu câu. Markdown được chuyển đổi sang 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 các đị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 thông tin tóm tắt nhanh về cú pháp Markdown, hãy nhấp vào trong thanh công cụ chỉnh sửa nhanh để xem tài liệu tham khảo nhanh về cú pháp Markdown.

Để hủy hoặc thực hiện 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 tương ứng.

Bạn nên sử dụng Markdown nếu muốn đơn giản hoá quy trình định dạng. Tuy nhiên, mã này không nhằm thay thế HTML. Có nhiều định dạng bạn có thể thực hiện trong HTML mà bạn không thể thực hiện trong Markdown. Ví dụ: bạn có thể chỉ định lớp CSS cho một phần tử trong HTML; bạn không thể thực hiện 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 nhập thẻ HTML.

Để biết thông tin về thẻ HTML, hãy xem thông số kỹ thuật HTML5.

Thêm 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 cho phép bạn nhanh chóng dễ dàng xây dựng giao diện người dùng nhất quán, thích ứng và dễ tiếp cận bằng cách sử 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 cổng thông tin được xây dựng bằng Angular Material và bạn chỉ có thể sử dụng một số thành phần Angular Material trong các trang, như 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ý chế độ 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ý sử dụng phiên bản thử nghiệm của tính năng đối tượng)

Để quản lý khả năng hiển thị của một trang trong cổng thông tin của bạn:

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ý sử dụng bản phát hành beta 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.
   • Người dùng xác thực để chỉ cho phép những người dùng đã đăng ký xem trang.
   • Đối tượng đã chọn để chọn những đối tượng cụ thể mà bạn muốn có thể xem trang. Xem bài viết Quản lý đối tượng cho cổng thông tin của bạn.
     Để 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 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. Di chuyển qua 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 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 trang web, 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.