yusanshi / emgithub

Embed a file from GitHub repository just like GitHub Gist.
https://emgithub.com
MIT License
409 stars 77 forks source link

emgithub

https://emgithub.com/

Embed a file from GitHub repository just like GitHub Gist.

Demo: https://yusanshi.com/posts/2019-12-17/emgithub/#%E6%B5%8B%E8%AF%95.

Get started

There are two ways to use the service:

  1. Go to https://emgithub.com/ and paste the URL.
  2. Open a file in GitHub and simply add "em" before "github.com" in the address bar.

ProTip

Development

You can modify the code and test it by launching an HTTP server in the project directory.

  1. Launch an HTTP server.
    git clone https://github.com/yusanshi/emgithub
    cd emgithub
    python -m http.server 8086
  2. Make the changes.
  3. Visit http://localhost:8086/404.html.

    Don't be confused by the "404". It is how the "adding em in the address bar" works: after adding the "em", the HTTP server (provided by GitHub Pages) can't find the file so it renders 404.html. Then in the 404 page, the target file is extracted from the URL.

Create your own emgithub

You may want to create your own emgithub for some reasons, like:

To do this, you can use either GitHub Pages or your own web server.

Use GitHub Pages

If you choose to use GitHub Pages just like https://emgithub.com/ does, you can fork the project and remove the CNAME file. Then go to Your repository - Settings - GitHub Pages to setup a custom domain or simply use username.github.io.

Use your own web server

If you choose to use your own web server, such as Apache and Nginx, the most important thing to do is to configure the server to serve 404.html for a not-found request.

For example, here is a simple configuration without HTTPS for Nginx:

server {
  listen 80;
  listen [::]:80;

  server_name your_domain.com;

  root /var/www/project_directory;

  location / {
    try_files $uri /404.html;
  }
}

Credits