8000端口是干什么的

Python 利用 mkdocs serve 命令轻松启动本地 MkDocs 服务,快速搭建静态网站
一、配置mkdocs.yml文件以个性化你的项目
mkdocs.yml 是 MkDocs 项目的核心配置文件,它采用 YAML 格式,允许你定义项目的结构、主题、插件和其他设置。以下是一个示例 mkdocs.yml 文件及其详细解释:
site_name: 我的文档站点
nav:
- 首页: index.md
- 关于: about.md
- 联系我们: contact.md
theme: material 可以选择多种内置主题
在 site_name 中填写你的文档站点名称,它将显示在导航栏或标题中。nav 部分设置导航栏,每个导航项由键值对构成,键为导航栏显示的名称,值为对应的 Markdown 文件路径。在示例中,我们设置了“首页”、“关于”和“联系我们”三个导航项。theme 字段指定使用的主题,MkDocs 提供了多个内置主题供选择。
除了这些基本设置,mkdocs.yml 还支持许多其他配置选项,如指定文档源文件目录(docs_dir)、生成的静态网站目录(site_dir)、添加自定义 CSS 和 JavaScript 文件(extra_css 和 extra_javascript),以及配置使用的插件(plugins)等。
二、安装并启动mkdocs serve
确保你已经安装了 MkDocs。如果尚未安装,可以通过以下命令进行安装:
pip install mkdocs
安装完成后,在终端中切换到你的 MkDocs 项目目录,然后运行以下命令启动本地服务器:
mkdocs serve
如果你想指定 IP 地址和端口,可以使用以下命令:
mkdocs serve -a 192.168.0.100 --port 8080 将 IP 和端口替换为你想要的设置
三、访问你的静态网站
启动成功后,本地服务器将在默认浏览器中打开你的 MkDocs 文档站点。通常情况下,MkDocs 默认使用 8000 端口。你可以在浏览器中输入 localhost:8000/ 来访问你的文档站点。
每当对文档进行更改时,MkDocs 会自动重新构建站点并在浏览器中刷新页面。这样你就可以专注于编写文档内容,无需手动重新构建和部署文档站点。这对于快速迭代和测试非常有用。
