Githubの上でMarkdownでデジタルCVをつくること


月初旬、私はTwitterで私の次の役割を探していると発表しました.私のつぶやきにリンクされてmy digital CV そして、以来、私は私がそれを構築した方法について多くの質問を受けました.だからここに短いガイドです!

This guide is based on a Twitter thread that I saw back in 2017. Unfortunately, I can’t remember who posted it… but if it was you, please know that I really appreciate you!


⚠️ 必要条件:
  • GitHub account
  • 快適さMarkdown
  • ✅ 手順:
  • Create a new public repository on GitHub
  • Enable GitHub Pages for your repository
  • Select a theme (design template) for your CV
  • Write your CV in Markdown

  • Enjoy 💅🏼
  • Optional: Set up a custom domain

  • Show me your CV 💌

  • で新しいパブリックリポジトリを作成する
    我々が我々のデジタルCVのために必要とするすべては、Githubの上で倉庫に住んでいます.畝
    出発する.create a new repository テンプレートなしで.

    名前を選択しますcv ) 必要に応じて説明を含める.ちょっとそれが一般的であることを確認してください.

    This digital CV will be hosted with GitHub Pages, which requires your repository to be public.


    そして最後に、何かで初期化しないでください.

    While you won't be importing an existing repository, it helps makes the process less complicated to start with a completely blank repository. You'll see why later!




    ページのgithubページを有効にする
    あなたのデジタルCVはホストされますGitHub Pages . Githubページでは、Githubリポジトリから直接個人やプロジェクトのページをホストすることができます.それは無料ですし、機能はGitHubに組み込まれているので、追加のアカウントや複雑なビルドパイプラインの必要はありませんので、それは素晴らしいです.
    あなたのCVのためのgithubページを有効にするために、あなたの倉庫のセッティングページに行きなさい.

    Githubページのセクションを見つけるまでスクロールします.ソースとテーマセレクタの2つのサブセクションがあります.

    Githubページのサイトを公開する前に、まずリポジトリにコンテンツを追加する必要がありますリポジトリが空なので、枝がなくソースを選択できません.いいよ.これは一時的に注意します.
    あなたが欲しいサブセクションはテーマセレクタです.ここでは、あなたのサイトのデザインテンプレートを選択します.これはgh-pages 支店とその支店から選択したテーマであなたのサイトを公開します.畝

    All of the options are Jekyll themes. If you don’t know Jekyll, that’s ok. This guide will walk you through the necessary configuration. Honestly, I have no idea how Jekyll works beyond GitHub Pages templates.



    あなたのCV用のテーマ(デザインテンプレート)を選択します
    CVSは将来の雇い主にあなたが誰であるかという考えを与えることになっています-それで、あなたに話すテーマを選んでください!このガイドのために、私たちのために使用するものであるので、我々は例として「最小限の」テーマを続けますmy CV .

    したら、あなたのテーマを選択すると、新しいindex.md ファイル.畝

    あなたがそれに飛び込む前に、あなたが知っていなければならないバックグラウンドで起こった若干のものがあります...
  • 新しいgh-pages 枝は以前(前述のように)作成された.
  • このindex.md ファイルが作成されました.畝
  • ジキルのテーマは“最小限”に設定されました.
  • githubページは、ファイルを作成することによってあなたのテーマ選択を確認します_config.yml . デフォルトでは、このファイルはtheme フィールドを選択します.畝
    ここで何が_config.yml あなたは“ミニマル”のテーマを選択した場合のようになります.
    theme: jekyll-theme-minimal
    
    私のCV用にもtitle and description フィールド
    theme: jekyll-theme-minimal
    title: 💻✒️📄🌟
    description: Carolyn Stransky's CV
    
    すべての設定可能性をチェックアウトすることができますJekyll documentation .

    あなたのCVをMarkdownに書いてください
    また、生成されたファイルに戻る.これは、すべてのあなたのCVのためのコンテンツがされます.
    まず、名前を変更する必要がありますindex.md ファイルREADME.md . これはオプションですが、ReadMeとして使用すると、人々があなたのリポジトリを訪問するときにすぐにあなたのCVのコンテンツを見ることができます.あなたが決めるならば、これは特に役に立ちますpin your CV repository to your GitHub profile .

    If there’s no index.md present, then your README will work automatically with GitHub Pages - no additional configuration required.


    次に、あなたのCVを書くことができます✍🏻

    あなたはwrite and style your content using Markdown そして、それはあなたの選択したテーマに応じてレンダリングされます.
    あなたのスキルを効果的にショーケースする方法についてのヒントのために、私はモニカLentの記事を推薦します:7 software developer resume tips to help you stand out .あなたがどのようにスタイルをあなたのコンテンツをマルダウンでインスピレーションを探しているならcheck out my digital CV .畝
    一度満足して、あなたの変更をgh-pages 枝.畝

    新しいデジタルCVを楽しむ
    それはライブに行くには数分かかるかもしれません-しかし、あなたの新鮮な、新しい、デジタルCVは、現在InterWeb🎉
    ほとんどの場合、次のURLであなたのページがホストされます.
    <github-username>.github.io/<repository-name>
    
    あなたは常にあなたのCVが発行されることを確認することができます、そして、URLはあなたの倉庫のセッティングのGithubページ部に戻ることによって何ですか.

    If your digital CV isn’t updating after pushing a commit and waiting a few minutes, try doing a hard refresh.



    オプション:カスタムドメインを設定する
    カスタムドメインは、あなたのCVのスタンドアウトを支援することができます-または代わりに、個人的なウェブサイトとしてデジタルCVを使用してください.
    確かに私のCV用のカスタムドメインを設定したことがありませんが、ここでの手順についてはステップバイステップの手順がありますGitHub documentation .畝

    If you’re not sure where to get domains, I like Namecheap.



    あなたのCVを見せてください
    あなたがこのガイドに従って、デジタルCVを構築するならば、私はそれを見たいです!つぶやき私のリンク💖
    あなたはこの便利な役に立つか?はいならばbuying me a coffee それで、私はこのようなポストを書き続けることができます☕️