{"id":13431350,"url":"https://github.com/random-yang/paper","last_synced_at":"2025-03-16T11:31:32.015Z","repository":{"id":37016379,"uuid":"221596023","full_name":"random-yang/paper","owner":"random-yang","description":"一个类纸风的主题paper 🎉","archived":false,"fork":false,"pushed_at":"2023-01-03T07:28:22.000Z","size":162,"stargazers_count":241,"open_issues_count":10,"forks_count":28,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-05-20T09:19:24.710Z","etag":null,"topics":["art","blog-theme","hexo-theme","paper"],"latest_commit_sha":null,"homepage":"https://www.figma.com/community/file/1182981536621476511","language":"Pug","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/random-yang.png","metadata":{"files":{"readme":"README.en.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-11-14T02:39:50.000Z","updated_at":"2024-05-16T01:05:23.000Z","dependencies_parsed_at":"2023-01-17T13:31:35.260Z","dependency_job_id":null,"html_url":"https://github.com/random-yang/paper","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/random-yang%2Fpaper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/random-yang%2Fpaper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/random-yang%2Fpaper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/random-yang%2Fpaper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/random-yang","download_url":"https://codeload.github.com/random-yang/paper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243862937,"owners_count":20360238,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["art","blog-theme","hexo-theme","paper"],"created_at":"2024-07-31T02:01:02.415Z","updated_at":"2025-03-16T11:31:31.299Z","avatar_url":"https://github.com/random-yang.png","language":"Pug","funding_links":[],"categories":["Content"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003epaper\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e🎨 paper is a concise hexo theme with no redundant visual elements and functions. Its design style is inspired by paper readings such as 📰 \u003cstrong\u003enewspaper\u003c/strong\u003e. And the theme implements the current (2019) popular 🌗\u003cstrong\u003eDark Mode\u003c/strong\u003e in a 💡\u003cstrong\u003eextremely clever\u003c/strong\u003e way, which can be enabled with one click. \u003c/p\u003e\n\n![landing](https://source-hosting.oss-cn-shanghai.aliyuncs.com/Paper-showcase.png)\n\n## Table of Contents\n\n- [How to use](#how-to-use)\n    - [Installation](#installation)\n    - [Configuration items](#configuration-items)\n- [Effect preview](#effect-preview)\n- [Update](#update)\n- [Porting version](#porting-version)\n- [Todo](#todo)\n- [Participate](#participate)\n- [LICENCE](#licence)\n\nCreated by [gh-md-toc](https://github.com/ekalinin/github-markdown-toc)\n\n## How to use\n\n#### Installation\n\n```bash\n# Under your hexo top-level folder\ncd themes\n# clone the project\ngit clone git@github.com:random-yang/paper.git\n```\n\nInstall stylus and pug conversion tools (due to hexo init, the following two may not be installed by default)\n\n```\nnpm install hexo-renderer-jade hexo-renderer-stylus --save\n```\n\nModify the configuration file\n\n```bash\n# Set in your _config.yml file\ntheme: paper\n# At the same time in order to highlight the code, you need to paste the following content into the file (if there is a highlight field before, remember to delete it and paste it)\nhighlight:\n  hljs: true\n  enable: true\n  line_number: false\n  auto_detect: true\n  tab_replace:''\n```\n\n```bash\n# Clear and recompile\nhexo clean \u0026\u0026 hexo s\n# done\n# In the temporarily opened local server, you should be able to see the blog with the paper theme applied!\n```\n\n#### Configuration items\n\nConfigure in the `_config.yml` file under the `theme/paper` directory\n\n- Social accounts\n\n```bash\nsocial:\n  Github: https://github.com/yours\n  Codepen: https://codepen.io/yours\n  Dribbble: https://dribbble.com/yours\n  twitter: https://twitter.com/yours\n  Know: https://www.zhihu.com/people/yours\n  Nuggets: https://juejin.im/user/yours\n  Mail: mailto:xxx@yourmail.xxxx\n  Rss: your-rss-link-url\n  # ...\n  # and more, you can add other link by the same way\n```\n\nIn addition to the provided, you can also add other unlisted\n\n- Theme color\n\n```bash\nmain_color: default # forest | grass | sky | sun | sea\n```\n\nHere are 6 colors that can be modified through direct configuration. Of course, if you don’t like it, you can enter `themes/paper/source/css/var.styl` to modify the variable to render the color you want.\n\n- Visible content in the right column\n\nUncomment means to close the content\n\n```bash\n# Uncomment to disable sidebar\n# toc: false\n# link: false\n# archives: false\n# categories: false\n# tags: false\n```\n\n- posts list preview post pictures\n\nWrite in the head of the article markdown:\n\n```bash\nphotos:\n-your-images-url\n# The following pictures will be ignored\n#-...\n#-...\n```\n\nBy default, only the first url in the list will be taken, and the following will be ignored.\n\n- google Analytics\n\n```bash\n# Google Analytics\ngoogle_analytics_id: xx-xxxxxxx-xx\n```\n\n- Top article\n\nWrite in the head of the article markdown:\n\n```bash\ntop: true\n```\n\n- Add Rss subscription\n\nAccording to the guidance of [hexo-generator-feed](https://github.com/hexojs/hexo-generator-feed), generate the `atom.xml` file, and then configure it in `themes/paper/_config.yml`\n\n```bash\nsocial:\n  -Rss: your-rss-link-url\n```\n\n- Comment module configuration\n\n```bash\n# comment module\ncomment:\n  enable: false # true to enable\n  type: valine # value: valine | utterances\n\n  # valine params\n  appId: your-app-id\n  appKey: your-app-key\n  placeholder: say something\n  notify: false\n  verify: false\n  avatar: mp\n\n  # utterances (https://utteranc.es/) params\n  repo: your github repo path which supports comment\n  issue_term: your issue term\n  theme: comment theme\n```\n\n- Open math formula\n\n1. Uninstall hexo-math\n```bash\nnpm uninstall hexo-math\n```\n2. Uninstall hexo-renderer-marked\n```bash\nnpm uninstall hexo-renderer-marked\n```\n3. Install hexo-renderer-kramed\n```bash\nnpm install hexo-renderer-kramed --save\n```\n4. Update _config.yml\n```bash\n# Add to\nmath:\n  engine:'mathjax'\n  mathjax:\n    enable: true\n    cdn: https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.4/MathJax.js?config=TeX-MML-AM_CHTML\n```\n5. Finally\n```\nhexo clean\nhexo server\n```\n\n## Effect preview\n\n- DarkMode\n  ![](https://source-hosting.oss-cn-shanghai.aliyuncs.com/paper-github-3.png)\n\n- Multiple colors\n  ![](https://source-hosting.oss-cn-shanghai.aliyuncs.com/paper-github-4.png)\n\n- Resposive\n  ![](https://source-hosting.oss-cn-shanghai.aliyuncs.com/paper-github-1.png)\n  ![](https://source-hosting.oss-cn-shanghai.aliyuncs.com/paper-github-2.png)\n\n## Update\n\n```bash\ncd themes/paper\ngit pull\n```\n\n## Porting version\n\n- [halo-theme-paper](https://github.com/halo-dev/halo-theme-paper)\n\n## Todo\n\n- [x] Ported to [other blogging platforms] (## transplant version) (the design is reusable)\n- [x] Article list\n- [x] Chrome mobile tab color\n- [x] Google Analytics\n- [x] Optimize SEO\n- [x] Optimize [Audit](https://web.dev/measure/) test performance\n- [x] The posts picture of the home page (parameters can be configured)\n- [x] Top of article (I only realized that the top feature is very important recently)\n- [x] RSS subscription function\n- [x] Latex\n- [ ] Picture zooming\n- [x] Determine whether to add a comment system based on the situation (the comment system is suitable for users to decide to use third-party comment plugins)\n- [ ] Global search\n- [ ] Optimized layout and subdivision fonts\n\n## Participate\n\nI personally read a lot of other themes and found that many have very rich functions. Due to the limited energy of the individual, only the main basic functions have been realized for this theme, which meets my basic requirements for vision. Other more features or suggestions for visual details are welcome to pr, issue🤟🏼.\n\n## LICENCE\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frandom-yang%2Fpaper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frandom-yang%2Fpaper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frandom-yang%2Fpaper/lists"}