Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

Nhập vào Aggrega

Những gì một lần nhập đọc và ghi, cùng các định dạng mà nó đọc, được mô tả trong Nhập; trang này trình bày cách chạy một lần nhập từ trình soạn thảo.

Aggrega: Import into Aggrega — soạn nháp các tệp biên soạn Aggrega từ một nguồn do công cụ khác viết. Đây cũng là nút Import trong nhóm Author của bảng Commands, và Import into Aggrega trên menu chuột phải của tệp hoặc thư mục trong Explorer, mục này nhập tệp hoặc thư mục bạn đã nhấp: cả ba là một lệnh, nên chúng hỏi cùng những câu hỏi, theo cùng thứ tự, mỗi câu trong ô nhập của chính trình soạn thảo, ngoại trừ mục trong Explorer không hỏi nguồn.

Đầu tiên là nguồn: File… hoặc Folder…, sau đó là hộp thoại mở của trình soạn thảo cho loại đó — lựa chọn này đến trước vì trên Windows và Linux một hộp thoại không thể cung cấp cả hai. Sau đó là thư mục bên trong không gian làm việc để soạn nháp vào, tương đối so với gốc của nó, trong đó để trống sẽ soạn nháp bên dưới gốc không gian làm việc, như aggrega import làm khi không có --output-dir. Sau đó là các tùy chọn, một danh sách trong đó bạn có thể đánh dấu Preview, Sync, cả hai hoặc không cái nào: Preview là --dry-run — không có gì được ghi, và mỗi tệp mà lần nhập sẽ ghi được hiển thị trên kênh đầu ra, theo sau là nội dung của nó — còn Sync là --sync, cập nhật những gì một lần nhập trước đã soạn nháp theo nguồn, chỉ thay đổi những gì lần nhập đã ghi, với mỗi phần được cập nhật được liệt kê trên kênh bằng những từ mà aggrega import --sync in ra cho nó; không đánh dấu cái nào sẽ ghi toàn bộ bản nháp. Cuối cùng là khả năng của nhà cung cấp cần soạn nháp một Manifest, chẳng hạn compose hoặc helm, trong đó để trống sẽ không soạn nháp gì, như khi không có --target. Một câu trả lời bạn để trống, và một tùy chọn bạn không đánh dấu, hoàn toàn không được gửi, nên trình biên dịch áp dụng mặc định riêng của nó, và đóng bất kỳ câu hỏi hoặc hộp thoại nào sẽ kết thúc lần nhập mà không gửi gì. Một thư mục dẫn ra ngoài không gian làm việc, và một khả năng mà không Recipe nào trong danh mục của không gian làm việc liên kết đến, sẽ bị trình biên dịch từ chối bằng lời của chính nó trước khi bất cứ thứ gì được ghi.

Câu hỏi đầu tiên của lần nhập, hỏi nguồn là tệp hay thư mục.

Định dạng được nhận ra từ hình dạng của chính nguồn, như tại terminal; khi trình biên dịch từ chối vì không có định dạng nào, hoặc có nhiều hơn một định dạng, nhận ra nguồn, trình soạn thảo hiển thị lời từ chối đó — trong đó nêu tên các định dạng — và hỏi định dạng để đọc nguồn, rồi gửi lại cùng lần nhập kèm định dạng đó, và để trống câu hỏi đó sẽ kết thúc lần nhập với lời từ chối. Lệnh đọc tệp bạn nêu tên, hoặc các tệp trong thư mục bạn nêu tên mà trình nhập của nó đọc, và không đọc gì khác. Lệnh không truy cập mạng, ngoại trừ để tải những gì một lần nhập cần để chạy mà máy này chưa có — một trong các trình nhập lõi của trình biên dịch, vào lần đầu tiên một định dạng cần nó, và, trong một không gian làm việc không nêu thư mục danh mục nào, bản chụp danh mục đã công bố mà lần nhập đọc làm danh mục của nó — mỗi thứ được tải từ registry mặc định của không gian làm việc, được xác minh và giữ trong bộ nhớ đệm nội dung, như aggrega import làm. Nguồn có thể nằm ở bất kỳ đâu trên máy này, vì đó là tệp bạn đã trỏ đến chứ không phải tệp mà không gian làm việc chứa; các bản nháp luôn được đặt trong không gian làm việc.

Lệnh hiển thị tiến trình kèm nút Cancel, và nhấn Cancel sẽ dừng quá trình chuyển đổi chứ không chỉ dừng việc chờ của trình soạn thảo, vì trình nhập chạy như một plugin mà trình biên dịch có thể gỡ bỏ giữa chừng.

Phần kết thúc cho biết nguồn được nhận ra là gì, bao nhiêu tệp đã được soạn nháp và chúng đi đâu, chỉ đếm các bản nháp chứ không đếm .aggrega-import.json, bản ghi về những gì lần nhập đã ghi mà mọi lần nhập đều ghi cạnh các bản nháp của nó; các phát hiện riêng của trình nhập và mọi tệp đã được ghi ra đĩa, kể cả bản ghi đó, được đưa đến kênh đầu ra Aggrega, vì chúng nêu một vị trí trong tệp nguồn chứ không phải trong một tài liệu bạn đã biên soạn. Khi một lần nhập ghi các bản nháp của nó để lại trong chúng những giá trị còn thiếu mà không nguồn nào có thể chứa, trình soạn thảo đề nghị hỏi bạn các giá trị đó, như mô tả trong Trả lời các giá trị mà một lần nhập vẫn còn thiếu.

Trả lời các giá trị mà một lần nhập vẫn còn thiếu

Một số giá trị mà bản nháp cần là những giá trị không nguồn nào có thể chứa — chẳng hạn image mà mã của chính bạn được build vào, email của một tài khoản chủ sở hữu, hoặc nơi một secret được lấy từ đó. Khi một lần nhập ghi các bản nháp của nó để trống những giá trị như vậy, trình soạn thảo đề nghị một lần, trong một thông báo nêu số lượng của chúng, để hỏi bạn các giá trị đó; bỏ qua lời đề nghị không thay đổi gì. Một bản xem trước không được đề nghị gì, cũng như aggrega import --dry-run không hỏi gì, vì không câu trả lời nào được áp dụng cho bản xem trước; các phát hiện của nó trên kênh đầu ra vẫn nêu từng giá trị còn trống. Nếu chấp nhận lời đề nghị, mỗi giá trị được hỏi trong một ô nhập riêng, theo thứ tự các bản nháp liệt kê chúng: tiêu đề của ô là tệp đã soạn nháp và khóa nơi giá trị nằm, và ô hỏi bằng mô tả giá trị của chính trình biên dịch, tức là câu hỏi mà aggrega import đặt ra tại terminal. Ô của một secret hỏi secret được lấy từ đâu, bằng lời của chính trình biên dịch — không bao giờ hỏi chính secret đó — và ẩn những gì bạn gõ. Một ô bạn để trống sẽ để giá trị đó vẫn còn thiếu, để trả lời sau trong tệp câu trả lời. Nhấn Escape trong bất kỳ ô nào sẽ kết thúc các câu hỏi và không gửi gì, kể cả những câu trả lời bạn đã gõ.

Sau đó, trình soạn thảo gửi lại lần nhập kèm các câu trả lời của bạn, với cùng tiến trình và nút Cancel, và các phát hiện, các tệp cùng phần kết thúc của nó được đưa đến kênh đầu ra như của lần nhập đầu tiên. Các câu trả lời được gửi kèm một lần đồng bộ, vì các bản nháp đã ở trên đĩa. Trình biên dịch ghi từng câu trả lời vào các bản nháp và giữ nó trong tệp câu trả lời mà aggrega import đọc, nên một lần nhập hoặc đồng bộ sau đó của nguồn ấy sẽ không hỏi lại; một giá trị mà tệp đó đã trả lời sẽ hoàn toàn không được hỏi. Một secret được trả lời bằng bất cứ thứ gì khác ngoài một tên chỉ nơi nó được lấy từ đó sẽ bị trình biên dịch từ chối bằng lời của chính nó và vẫn còn thiếu. Bất cứ giá trị nào các bản nháp vẫn còn thiếu sau khi lần nhập được gửi lại sẽ được đề nghị theo cùng cách.