当前位置: 首页 > Web前端 > HTML5

使用mkdocs将静态网页部署到GitHubpages

时间:2023-04-05 18:01:15 HTML5

信息:官网:MkDocs我的个人网站成果:http://wcowin.work/1.准备工作1.下载GithubDesktop2.拥有GitHub账号二、Creatingyoursite参考教程:网站制作-Wcowin的个人网站与之前的教程有所不同。我首先建议在Github上创建一个名为你的名字+github.io的仓库,然后打开githubDesktop,克隆到本地打开Wcowin,在终端中输入.github.io目录,运行:mkdocsnewmkdocs-site里面出现几个文件下图。docs文件是未来网站的内容,mkdocs.yml是配置文件(配置主题、目录、插件等)你在这个目录下写的任何东西都可以通过github桌面上传到github。以VScode为例。我们打开看看里面有什么(建议先执行以下代码添加一个GitHubWorkflow)1.$mkdir.github2.$cd.github3.$mkdirworkflows4.$cdworkflows5.$vimPublishMySite.yml目录树diagram:$tree-a.├──.github│├──.DS_Store│└──workflows│└──PublishMySite.yml├──docs│└──index.md└──mkdocs.yml3.完成配置打开mkdocs.yml,输入以下内容(最简单的配置)site_name:网站名称site_url:site_author:你的名字theme:name:material#Theme详情mkdocs.yml配置见Changingthecolors-MaterialforMkDocs下次我将详细讨论这个问题。运行下面的终端,可以在浏览器中看到实时网站mkdocsserve。就算网站初建好了,去github桌面,上传到github你的网站URL是:https://你的github名字.github.io/下回说说网站的具体配置