> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/porters-handbook/di-2-zhang-zhi-zuo-xin-de-port/di-2-zhang-zhi-zuo-xin-de-port.md).

# 2.1.制作新的 Port

想要创建新 Port，或升级现有的 Port？太好了！

接下来是一些为 FreeBSD 创建新 Port 的指导方针。要升级现有的 Port，请阅读本文，然后阅读[升级 Port](https://docs.freebsd.org/en/books/porters-handbook/upgrading/#port-upgrading)。

当本文档内容不够详细时，请参考 **/usr/ports/Mk/bsd.port.mk**，所有 Port 的 `Makefile` 都会包含该文件。即使不是每天修改 `Makefile` 的人，也能从中获得大量知识。此外，具体的问题可以发送到 [FreeBSD Ports 邮件列表](https://lists.freebsd.org/subscription/freebsd-ports)。

> **注意**
>
> 本文档仅提到了一小部分可以被覆盖的变量（`VAR`）。大部分（如果不是全部的话）已在 **/usr/ports/Mk/bsd.port.mk** 开头处说明；其余的可能也应当加以说明。请注意，该文件使用了非标准的制表符设置：Emacs 和 Vim 会在加载该文件时识别该设置。加载文件后，通过输入 `:set tabstop=4` 可以将 [vi(1)](https://man.freebsd.org/cgi/man.cgi?query=vi\&sektion=1\&format=html) 和 [ex(1)](https://man.freebsd.org/cgi/man.cgi?query=ex\&sektion=1\&format=html) 都设置为正确的值。

想找一些简单的入门项目？查看 [请求的 Port 列表](https://wiki.freebsd.org/WantedPorts)，看看你是否能着手处理其中一个（或多个）。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://book.bsdcn.org/porters-handbook/di-2-zhang-zhi-zuo-xin-de-port/di-2-zhang-zhi-zuo-xin-de-port.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.