Avatar

Organizations

  • 设置流程

    不过多说明了,网上教程非常多,可以找来看。

    参考文档

    各种坑位

    1. 网页正常部署后,访问时页面却无法正常显示,部局完全是乱的。

    这可能是https请求报"block:mixed-content"错误导致的,是浏览器不允许在https页面里嵌入http的请求,现在高版本的浏览器为了用户体验,都不会弹窗报错,只会在控制台上打印一条错误信息。

    解决这个问题,可以从以下2点入手:

    1.1. 在"theme/<YouThemeName>/layouts/partials/head.html"文件内,添加代码

    <meta http-equiv="Content-Security-Policy" content="upgrade-insecure-requests">
    

    1.2. 确保config.toml文件内,“baseUrl"的值与实际地址一致。

    2. config.toml 里的 theme 值,要与主题文档夹名一致,不然可能会导致主题无法应用的问题。

    3. Github Actions 设置里的 gh-pages.yml 写法要注意

    “Setup Hugo"项目里,标准版本与扩展版本的参数写法不一样。

    # 使用扩展版本
    - name: Setup Hugo
      uses: peaceiris/actions-hugo@v2
      with:
        hugo-version: '0.92.0'
        extended: true
    
    # 使用标准版本
    - name: Setup Hugo
      uses: peaceiris/actions-hugo@v2
      with:
        hugo-version: 'latest'
    

    4. 自定义域名

    4.1. 在"theme/<YouThemeName>/static"目录下,添加CNAME文件,里面放自定义的域名

    blog.cuile.com
    

    上传后,Settings -> Pages -> Custom domain 设置中会出现自定义的域名

    4.2. 修改 baseurl

    Hugo Github Action Blog Created Fri, 14 Jan 2022 17:15:06 +0800
  • 镜像列表

    [docker|podman] image ls -a
    # or
    [docker|podman] images
    

    容器列表

    [docker|podman] container ls -a
    # or
    [docker|podman] ps
    

    查看输出

    [docker|podman] compose -f <yaml_file> logs [-f] [service name]
    # or
    [docker|podman] logs [-f] [container id]
    

    验证配置文件

    [docker|podman] compose -f <yaml_file> config
    

    删除冗余镜像

    echo 'y' | [docker|podman] system prune
    

    导入导出镜像

    # 导出
    [docker|podman] save -o <image>.tar <image_name:label | image_id>
    # 导入
    # 使用image_id导出的镜像,导入时也没有名字
    [docker|podman] load -i <image>.tar
    

    不启动镜像,查看镜像内的文件

    # 创建临时容器
    [docker|podman] conatiner create --name <container_name> <image_name>
    # 从容器复制文件到宿主机
    [docker|podman] conatiner cp <container_name>:<file_path> <dest_path>
    # 清理临时窗口
    [docker|podman] container rm <container_name>
    

    创建桥接网络

    [docker|podman] network create [name]
    

    [docker|podman]快捷命令

    echo "alias d-ll='[docker|podman] image ls -a; echo; [docker|podman] container ls -a'" >> ~/.bashrc \
        && echo "alias d-ps='[docker|podman] ps'" >> ~/.bashrc \
        && echo "alias d-clean='[docker|podman] system prune -f'" >> ~/.bashrc \
        && echo "alias d-rm='_a(){ [docker|podman] image rm $1; echo; [docker|podman] container rm $1; }; _a'" >> ~/.bashrc \
        && echo "alias d-exec='_a(){ [docker|podman] exec -it $1 /bin/bash; }; _a'" >> ~/.bashrc \
        && echo "alias d-stop='_a(){ [docker|podman] container stop $1; }; _a'" >> ~/.bashrc \
        && echo "alias d-kill='_a(){ [docker|podman] container kill $1; }; _a'" >> ~/.bashrc
        
    source ~/.bashrc
    
    CLI docker podman container Created Thu, 13 Jan 2022 22:20:52 +0800
  • Python 的 pypi.python.org 站点终于要退休了,而新的接任者 pypi.org 无论从美观、风格上都让人大大的喜欢,终于在审美一这项上及格了。

    而且新的 pypi.org 能够正确的渲染 Markdown 格式的描述,实在是让人欣慰,终于可以和 Github 同步了,不用在麻烦的转换一次了。

    下面就来聊聊,如何正确的把库发布到 pypi.org 上:

    1. 注册 pypi.org 账号

    嗯,这是正确的废话!

    2. 编写 setup.py

    setup.py 的内容比较重要,但其它的细节不谈,主要聊聊 long_description 部分,这部分是对库能力的详细描述。

    如果说 keywords 和 description 能提高别人搜索到项目的概率的话,那 long_description 就在很大程度上决定别人对你对项目有没有进一步的想法了。

    在针对 long_description 的网上介绍中,对具体使用方法明确写出的是少之又少,所以我今天就特别举例说明一下。

    2.1 setup.py

    #!/usr/bin/env python
    # coding: utf-8
    
    from setuptools import setup
    
    setup(
    name='sequence2hash',
    version='1.1.2',
    keywords='tuple dict list sequence hash key/value',
    packages=['sequence2hash'],
    
    url='https://github.com/Cuile/sequence2hash',
    description='This tool converts a valid value in a sequence to a hash and contains a path to a valid value in the key field',
    long_description_content_type='text/markdown',
    long_description=open('README.md', encoding='utf8').read(),
    
    author='cuile',
    author_email='[email protected]'
    )
    

    2.2 读取 readme.md 文件

    long_description=open('README.md', encoding='utf8').read()
    

    这句代码是较少明确说明的,可以不引用 io 库,而直接使用 open 函数读取文件内容,由于 pypi.org 支持 Markdown ,所以可以和 Github 使用同一份 README.md 文件。

    PyPi Python Created Fri, 11 May 2018 14:49:57 +0800