git托管怎么使用_使用Git构建和托管网站

git托管怎么使用

Git是那些设法将大量现代计算封装到一个程序中的罕见应用程序之一，最终成为许多其他应用程序的计算引擎。 尽管它最着名的是跟踪软件开发中的源代码更改，但它还有许多其他用途，可以使您的生活更轻松，更有条理。 在4月7日Git成立14周年之前的系列文章中，我们将分享7种鲜为人知的Git使用方法。

创建一个网站过去既非常简单，又一次充满了黑魔法。 回顾Web 1.0的早期（实际上并不是所有人所说的），您可以打开任何网站，查看其源代码，并对HTML进行反向工程（包括所有内联样式和基于表的布局），然后一两个下午后感觉像个程序员。 但是仍然存在在Internet上获取您创建的页面的问题，这意味着要处理服务器，FTP和webroot目录以及文件权限。 自那时以来，现代网络已经变得更加复杂，但是如果您让Git帮助您，那么自我发布也可以变得同样容易（或更容易！）。

使用Hugo创建网站

Hugo是一个开源静态站点生成器。 静态站点是Web曾经建立的基础（如果回溯得足够远，那就是Web的全部内容了）。 静态站点有几个优点：它们相对容易编写，因为您不必编写代码；它们相对安全，因为页面上没有执行任何代码；并且它们速度非常快，因为没有任何处理转移页面上的所有内容。

雨果不是唯一的静态站点生成器。 Grav ， Pico ， Jekyll ， Podwrite和其他许多工具提供了一种简便的方法，可以以最少的维护来创建功能齐全的网站。 Hugo恰好是内置GitLab集成的平台，这意味着您可以使用免费的GitLab帐户生成并托管您的网站。

雨果也有一些非常大的粉丝。 例如，如果您曾经去过Let's Encrypt网站，那么您使用的是使用Hugo构建的网站。

安装雨果

Hugo是跨平台的，您可以在Hugo的入门资源中找到MacOS，Windows，Linux，OpenBSD和FreeBSD的安装说明。

如果您使用的是Linux或BSD，则最容易从软件存储库或端口树安装Hugo。 确切的命令取决于您的发行版提供的内容，但是在Fedora上，您将输入：

 $ sudo dnf install hugo 

通过打开终端并键入以下命令来确认您已正确安装它：

 $ hugo help 

这会打印hugo命令可用的所有选项。 如果看不到，则可能是Hugo安装不正确，或者需要将该命令添加到path中 。

建立您的网站

要建立一个Hugo网站，您必须具有特定的目录结构，Hugo将通过输入以下内容为您生成该目录结构：

 $ hugo new site mysite 

现在，您有了一个名为mysite的目录，其中包含构建Hugo网站所需的默认目录。

Git是使您的网站访问Internet的界面，因此将目录更改为新的mysite文件夹，并将其初始化为Git存储库：

   
   

    
    

     
     $ cd mysite
     
     

$ git init .
    
    
   
   

Hugo非常适合Git，因此您甚至可以使用Git为您的网站安装主题。 除非计划开发要安装的主题，否则可以使用--depth选项克隆主题来源的最新状态：

   
   

    
    

     
     $ git clone --depth 1 \
     
     

https://github.com/darshanbaral/mero.git\
     
     

themes/mero
    
    
   
   

现在为您的网站创建一些内容：

 $ hugo new posts/hello.md 

使用您喜欢的文本编辑器编辑content / posts目录中的hello.md文件。 Hugo会在发布时接受Markdown文件并将其转换为主题HTML文件，因此您的内容必须为Markdown格式 。

如果要在帖子中包含图像，请在静态目录中创建一个名为images的文件夹。 将您的图片放入此文件夹，并使用/ images开头的绝对路径在标记中引用它们。 例如：

 ![A picture of a thing](/images/thing.jpeg) 

选择一个主题

您可以在themes.gohugo.io上找到更多主题，但是最好在测试时保持基本主题。 规范的雨果测试主题是Ananke 。 有些主题具有复杂的依赖性，而另一些主题则无法在没有复杂配置的情况下呈现您期望的页面。 本示例中使用的Mero主题与详细的config.toml配置文件捆绑在一起，但是（为简单起见），我仅在此处提供基础知识。 在文本编辑器中打开名为config.toml的文件，并添加三个配置参数：

   
   

    
    

     
     languageCode = "en-us"
     
     

title = "My website on the web"
     
     

theme = "mero"
     
     


     
     

[params]
     
     

  author = "Seth Kenlon"
     
     

  description = "My hugo demo"
    
    
   
   

预览您的网站

在准备发布之前，您无需在互联网上放置任何内容。 在工作时，您可以通过启动Hugo随附的仅限本地的Web服务器来预览站点。

 $ hugo server --buildDrafts --disableFastRender 

打开Web浏览器并导航到http：// localhost：1313以查看您的工作正在进行。

使用Git发布到GitLab

要在GitLab中创建存储库，请在GitLab项目页面中单击“ 新建项目”按钮。 创建一个名为yourGitLabUsername.gitlab.io的空存储库，将GitLabUsername替换为GitLab用户名或组名。 您必须使用此方案作为项目的名称。 如果以后要添加自定义域，则可以。

不要包括许可证或自述文件（因为您是在本地启动项目的，因此现在添加这些项目会使将数据推送到GitLab变得更加复杂，您以后可以随时添加它们）。

在GitLab上创建空存储库后，将其添加为您的Hugo网站本地副本的远程位置，该站点已经是Git存储库：

 $ git remote add origin git@gitlab.com:skenlon/mysite.git 

创建一个名为.gitlab-ci.yml的GitLab站点配置文件，然后输入以下选项：

   
   

    
    

     
     image: monachus/hugo
     
     


     
     

variables:
     
     

  GIT_SUBMODULE_STRATEGY: recursive
     
     


     
     

pages:
     
     

  script:
     
     

  - hugo
     
     

  artifacts:
     
     

    paths:
     
     

    - public
     
     

  only:
     
     

  - master
    
    
   
   

image参数定义了将为您的网站提供服务的容器化图像。 其他参数是告诉GitLab服务器将新代码推送到远程存储库时要执行哪些操作的指令。 有关GitLab的CI / CD（连续集成和交付）选项的更多信息，请参阅GitLab的文档的CI / CD部分 。

设置排除

Git存储库已配置，在GitLab服务器上构建站点的命令已设置，并且站点已准备好发布。 对于您的第一次Git提交，您必须采取一些额外的预防措施，以免您不打算对版本进行控制。

首先，将Hugo建立网站时创建的/ public目录添加到.gitignore文件中。 您无需在Git中管理完成的网站； 您需要跟踪的只是您的Hugo源文件。

 $ echo "/public" >> .gitignore 

如果不创建Git子模块，则无法在Git存储库中维护Git存储库。 为了简单起见，请移动嵌入的.git目录，以使主题只是主题。

请注意，您必须将主题文件添加到Git存储库中，以便GitLab可以访问主题。 如果不提交主题文件，则站点将无法成功构建。

 $ mv themes/mero/.git ~/.local/share/Trash/files/ 

或者，使用垃圾桶命令，例如Trashy ：

 $ trash themes/mero/.git 

现在，您可以将本地项目目录的所有内容添加到Git并将其推送到GitLab：

   
   

    
    

     
     $ git add .
     
     

$ git commit -m 'hugo init'
     
     

$ git push -u origin HEAD
    
    
   
   

与GitLab一起上线

将代码推送到GitLab之后，请查看您的项目页面。 图标表示GitLab正在处理您的构建。 第一次输入代码可能要花费几分钟，因此请耐心等待。 但是，请不要太耐心，因为图标并不总是可靠地更新。

在等待GitLab组装站点时，请转到项目设置并找到“ 页面”面板。 网站准备就绪后，将为您提供其URL。 该URL为yourGitLabUsername.gitlab.io/yourProjectName 。 导航到该地址以查看您的劳动成果。

如果您的站点无法正确组装，则GitLab可以洞察CI / CD管道日志。 查看错误消息，以了解发生了什么问题。

Git和网络

Hugo（或Jekyll或类似工具）只是利用Git作为您的Web发布工具的一种方法。 使用服务器端Git挂钩，您可以以最少的脚本设计自己的Git到Web管道。 随着GitLab的社区版，您可以自行举办自己的GitLab实例，或者你可以像使用替代Gitolite或Gitea并使用此文章为灵感定制的解决方案。 玩得开心！

翻译自: https://opensource.com/article/19/4/building-hosting-website-git

git托管怎么使用