8000端口是干什么的


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 会自动重新构建站点并在浏览器中刷新页面。这样你就可以专注于编写文档内容,无需手动重新构建和部署文档站点。这对于快速迭代和测试非常有用。

  8000端口是干什么的