Làm thế nào để tạo một manpage?

Tôi đang đóng gói một chương trình cho Ubuntu, và tôi nhận được một cảnh báo lintian nói rằng nhị phân của tôi cần một trang.

Làm thế nào để đi về việc tạo một trang web cho một chương trình?

Với sự trợ giúp của Gmanedit, bạn có thể tạo các trang web với GUI đồ họa.

Gtk + Manpages Editor là trình chỉnh sửa cho các trang man chạy trên X với GTK +.

Gmanedit là một ứng dụng cho phép bạn chỉnh sửa các trang thủ công (man) trên các hệ thống Linux / Unix.

Nó giống như hầu hết các trình soạn thảo HTML phổ biến nhưng dễ dàng hơn. Bạn cần biết định dạng trang.

Theo các trang web chương trình người dùng Debian FHS được lưu trữ trong usr/share/man/man1hoặc usr/local/share/man/man1.

Sau khi thay đổi trang, có thể là khôn ngoan để cập nhật cơ sở dữ liệu trang bằng cách chạy mandbtrong một thiết bị đầu cuối.

Chi tiết về cú pháp manpage được tóm tắt trong manpage cho người đàn ông .

Bạn có thể viết các trang trong docbook / refentry, một định dạng tài liệu XML,

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">

<refentry id='vfplot1'>
<refentryinfo><date>1 July 2008</date></refentryinfo>
<refmeta>
<refentrytitle>VFPLOT</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class='date'>1 July 2008</refmiscinfo>
</refmeta>
<refnamediv id='name'>
<refname>vfplot</refname>
<refpurpose>plot vector fields with curved arrows.</refpurpose>
</refnamediv>
<refsynopsisdiv id='synopsis'>
<cmdsynopsis>
  <command>vfplot</command>    
  <arg choice='opt'>-a <replaceable>aspect</replaceable></arg>
  <arg choice='opt'>-d <replaceable>file</replaceable></arg>
  <arg choice='opt'>-D <replaceable>pen</replaceable></arg>
    :

và sau đó chuyển đổi kết quả sang định dạng man bằng cách sử dụng

xsltproc /path/to/docbook.xsl vfplot.xml

lên html với

docbook2html docbook2html

vân vân Đây không phải là cách dễ nhất để viết một trang chủ, nhưng nếu bạn đã viết XML trước đó thì bạn đã biết cú pháp rồi, đó chỉ là vấn đề học các thẻ để sử dụng.

Đưa ra một vòng xoáy Tôi vừa tải nó lên Tôi viết một số ứng dụng và đã gặp rắc rối với một trình soạn thảo trang man phong nha

http://gtk-apps.org/content/show.php/Man+Page+Editor+?content=160219

Đây là một ứng dụng gtk2 với một tab riêng cho từng phần nhập các bản xem trước và xuất các trang web đều được hỗ trợ, không có lệnh định dạng bí truyền, điều này vẫn đang được phát triển nhưng chắc chắn đủ ổn định để sử dụng.

Bạn có thể làm điều đó với autotools. GNU đã xuất bản ví dụ trong đó một dự án C cài đặt một manpage với autotools.