code2html - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

code2html - Chuyển đổi mã nguồn chương trình sang HTML

SYNOPSIS

(1) mã2html [lựa chọn] [tập tin đầu vào [tập tin đầu ra]]

(2) mã2html -p [hồ sơ [luân phiên-outfile]]

(3) mã2html (dưới dạng tập lệnh CGI; xem phần trên CGI)

MÔ TẢ

mã2html là một tập lệnh perl chuyển đổi mã nguồn chương trình thành cú pháp được đánh dấu
HTML hoặc bất kỳ định dạng nào khác cho quy tắc wich được xác định.

(1) LỰA CHỌN
tập tin đầu vào
Là tệp chứa mã nguồn chương trình được định dạng. Nếu không
được chỉ định hoặc dấu trừ (-) được đưa ra, mã sẽ được đọc từ STDIN.

tập tin đầu ra
Là tệp để ghi mã định dạng vào. Nếu không được chỉ định hoặc dấu trừ (-) là
đã cho, mã sẽ được ghi vào STDOUT.

-l, --ngôn ngữ-chế độ
Chỉ định tập hợp các biểu thức chính quy để sử dụng. Chúng phải được xác định trong
tệp ngôn ngữ (xem CÁC TẬP TIN phía dưới). Để tìm hiểu chế độ ngôn ngữ nào được xác định,
phát hành một mã2html --chế độ.

Đầu vào này được xử lý không phân biệt chữ hoa chữ thường.

Nếu không được đưa ra, một số phép phỏng đoán sẽ được sử dụng để xác định ngôn ngữ tệp.

-v, --dài dòng
In thông tin tiến độ sang STDERR.

-n, --số tuyến tính
In ra mã nguồn với số dòng.

-N, - số liên kết
In ra mã nguồn với số dòng. Các số vải sẽ liên kết đến
chính chúng, giúp dễ dàng gửi liên kết đến các dòng.

-P, --tiếp đầu ngữ
Tiền tố tùy chọn để sử dụng cho neo số dòng.

-t, - các tab thay thế[=CHIỀU RỘNG TABSTOP]
Thay thế mỗi lần xuất hiện của một ký tự với số lượng khoảng cách phù hợp để lấy
đến tab tiếp theo. Mặc định là chiều rộng tabstop gồm 8 ký tự.

-L, --ngôn ngữ-tệp=NGÔN NGỮ-FILE
Chỉ định một tệp thay thế để lấy định nghĩa ngôn ngữ và định dạng đầu ra từ
(xem phần trên CÁC TẬP TIN dưới đây).

-m, --chế độ
In tất cả các chế độ ngôn ngữ và định dạng đầu ra hiện được xác định thành STDOUT và thoát
thành công tốt đẹp. Cũng in các chế độ từ một NGÔN NGỮ-FILE được cho bởi --ngôn ngữ-tệp if
áp dụng.

--backback=NGÔN NGỮ
Nếu chế độ ngôn ngữ được cung cấp với --ngôn ngữ-chế độ không thể được tìm thấy sau đó sử dụng cái này
chế độ.

--backback đồng bằng ví dụ là hữu ích khi mã2html được gọi từ một tập lệnh thành
đảm bảo đầu ra được tạo ra.

-h, --Cứu giúp
In một trợ giúp ngắn và thoát thành công.

-V, --phiên bản
In phiên bản chương trình và thoát thành công.

-c, - loại nội dung
In ”Loại nội dung: text / html \ n \ n“ (hoặc bất kỳ định dạng đầu ra nào xác định là
content-type) trước phần còn lại của đầu ra. Hữu ích nếu tập lệnh được sử dụng là
một tập lệnh cgi.

-o, --định dạng đầu ra
Chọn định dạng đầu ra. html là mặc định. Để tìm ra định dạng đầu ra nào
được xác định, phát hành một mã2html --chế độ.

-H, --Không tiêu đề
không sử dụng mẫu được xác định bởi định dạng đầu ra. Đối với HTML, điều này có nghĩa là
rằng sẽ không có , , và không
thẻ.

--bản mẫu=FILE
ghi đè mẫu mặc định cho định dạng đầu ra đã cho. Nếu như --Không tiêu đề is
đã đưa ra, điều này không có ý nghĩa gì, vì dù sao thì mẫu cũng bị bỏ qua.

-T, --chức vụ
Đặt tiêu đề của tệp đầu ra đã tạo. Chỉ hoạt động nếu mẫu đó
hỗ trợ đặt tiêu đề.

-w, - chiều rộng=CHIỀU RỘNG DÒNG
Quấn dòng sau CHIỀU RỘNG DÒNG nhân vật. Mặc định là không quấn dòng nào cả.

-b, --linebreakprefix=CỐ ĐỊNH DÒNG
Sử dụng TIỀN TỆ khi bắt đầu các dòng được bọc. Mặc định là "» ".

(2) HTML vá
mã2html -p [hồ sơ [luân phiên-outfile]]

mã2html cũng cho phép bạn có mã nguồn nội tuyến trong một tệp html. Sau đó nó có thể mất
tệp html này và chèn mã đánh dấu cú pháp.

Nếu không có tệp nào được cung cấp, mã2html đọc từ STDIN và ghi vào STDOUT. Nếu chỉ một tệp là
vì nó sẽ thay thế tệp này bằng đầu ra. Nếu hai tệp được cung cấp, tệp đầu tiên là
đọc từ và cái thứ hai được viết tới.

Để sử dụng tính năng này, chỉ cần chèn một đoạn như thế này vào tệp html của bạn:

-->

tệp được đánh dấu cú pháp sẽ được chèn tại vị trí này kèm theo các thẻ.

Tất cả các tùy chọn có thể được đưa ra trên dòng lệnh như --số tuyến tính vv làm việc. --Cứu giúp,
--phiên bản, vv hoạt động quá nhưng nó không phải là rất thông minh để sử dụng chúng :). Sử dụng
--định dạng đầu ra để chọn một định dạng đầu ra không phải HTML là không thể tư vấn. - loại nội dung is
mặc kệ.

Bạn cũng có thể viết mã nguồn của chương trình trực tiếp trong tệp html với phần sau
cú pháp:

<!-- code2html thêm [tùy chọn]



->

Nó thường là một ý kiến ​​hay nếu ít nhất đưa ra --ngôn ngữ-chế độ tùy chọn để chỉ định
ngôn ngữ.

(3) CGI
Nếu tập lệnh được sử dụng làm tập lệnh CGI (GATEWAY_INTERFACE môi trường thiết lập và không
đối số dòng lệnh đã cho) mã2html đọc các đối số từ chuỗi truy vấn
hoặc từ SDTIN. (phương thức POST và GET).

- loại nội dung được bật tự động và đầu ra luôn chuyển sang STDOUT.

Các tham số / tùy chọn sau được chấp nhận:

chế độ ngôn ngữ - không bắt buộc
`c ',` cc', `pas ', v.v.

nếu không được đưa ra, một số phương pháp phỏng đoán được sử dụng để tìm ra ngôn ngữ.

dự phòng - không bắt buộc
`` trơn '', `c ', v.v. nếu không tìm thấy chế độ ngôn ngữ, hãy sử dụng chế độ này

bộ chọn đầu vào - không bắt buộc
`` tệp '', `cgi-input1 ',` cgi-input2' hoặc `REDIRECT_URL '

default: tệp

tên tập tin
tập tin để đọc từ nếu bộ chọn đầu vào là 'tập tin'

cgi-input1
Mã nguồn để tô sáng cú pháp. Ví dụ từ một hoặc từ một
tải lên. Nhìn thấy bộ chọn đầu vào.

cgi-input2
Mã nguồn để tô sáng cú pháp. Ví dụ từ một hoặc từ một
tải lên. Nhìn thấy bộ chọn đầu vào.

số dòng - không bắt buộc
`` có '', `` không '' hoặc `` liên kết ''

mặc định: không

tab thay thế - không bắt buộc
Nếu 0 thì các tab không được thay thế, nếu không, hãy thay thế mỗi lần xuất hiện của một tính cách
với số lượng khoảng trống phù hợp để đến đầu tab tiếp theo.

mặc định: 0

tiêu đề - không bắt buộc
Đặt là tiêu đề của tệp.

không mã hóa - không bắt buộc
Theo mặc định mã2html cố gắng mã hóa đầu ra dưới dạng bz2/gz/Z nếu khách hàng
hỗ trợ điều này (HTTP_ACCEPT_ENCODING) và chương trình cần thiết có sẵn trên
người phục vụ. Bạn có thể cần phải sửa đổi @CGI_ENCODING trong kịch bản để phù hợp với chương trình của bạn
Địa điểm.

If không mã hóa được định nghĩa là "đúng" mã2html không cố gắng mã hóa đầu ra.

Tại sao bạn có thể hỏi hai đầu vào cgi: Điều này là để cho phép người dùng của bạn chọn vie a
giao diện cho dù họ muốn chèn tệp của họ vào một hoặc người dùng một <browse>
để chọn tệp của họ. Xem ví dụ trên trang chủ của tôi.

Lưu ý rằng nếu $ FILES_DISALLOWED_IN_CGI là 0, người dùng của bạn có thể đọc tất cả
các tệp mà httpd có thể đọc (nếu bạn không chạy cgi- wrapper hoặc thứ gì đó tương tự. Bằng cách
mặc định giá trị này được đặt thành 1, vì vậy không được phép đọc tệp qua cgi. Bạn có thể
cho phép nó với cài đặt $ FILES_DISALLOWED_IN_CGI đến 0 ở đầu tập lệnh.

Bộ chọn đầu vào CHUYỂN HƯỚNG URL cần một cách giải thích đặc biệt. Tên tệp được hình thành từ
hai biến môi trường DOCUMENT_ROOT và CHUYỂN HƯỚNG URL.

Nếu bạn muốn apache tự động gọi mã2html cho tất cả các tệp mã nguồn của chương trình, bạn
có thể thực hiện việc này bằng cách thêm hai dòng này vào srm.conf của bạn:

AddHandler text / x-sourcecode .c .cc .cpp .pas .h .p

Văn bản hành động / x-sourcecode / cgi-bin / code2html? Input-selector = REDIRECT_URL & foo =

hoặc một cái gì đó tương tự như thế này. Trong dòng AddHandle, bạn có thể chọn các tiện ích mở rộng
đi qua mã2html.

CẢNH BÁO: Không thêm .pl vào dòng này và đặt tên tập lệnh này là “code2html.pl”. Điều này sẽ dẫn đến
trong một vòng lặp.

Đồng thời đảm bảo rằng bạn tải mô-đun Hành động (srm.conf).

Thay thế / cgi-bin / code2html bằng vị trí ảo mà tệp có thể được truy cập.
Lưu ý phần “foo =”. Apache nối URL của tệp để hiển thị ở cuối
phần hành động. Chúng tôi không cần điều này vì chúng tôi sử dụng biến môi trường CHUYỂN HƯỚNG URL
tuy nhiên, chúng tôi không muốn thêm url vào chuỗi bộ chọn đầu vào. Do đó chúng tôi
nối phần “& foo =”.

Tnx cho Kevin Burton[email được bảo vệ]> cho ý tưởng. Anh ấy cũng nói rằng

> Sẽ mạnh mẽ hơn nếu bạn sử dụng nó trong Apache
> nhãn
>
>
>
> # với thẻ Hành động của bạn ở đây ... theo cách này, bạn có thể
> # vẫn có tệp .java thông thường trên máy chủ của bạn.
>
>
>

THÍ DỤ

giả định mã2html nằm trong thư mục hiện tại, bạn có thể nhập

code2html -l perl code2html.pl code2html.html

để chuyển đổi tập lệnh thành tệp html.

Sử dụng code2html trực tuyến bằng các dịch vụ onworks.net