Giter VIP home page Giter VIP logo

hmcl-docs's Issues

为全站HTML界面设定默认字体

为全站HTML界面设定默认字体
HMCL-dev/HMCL#3016
可能可以解决?
比如GitHub在HTML的body中添加了:

font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";

[Discussion] `XXX - XXX` OR「XXX」-「XXX」

#123

[Burning_TNT]

讨论一下:对于启动器内路径的展示,是否应当使用代码块?

[3gf8jv4dv]

My personal opinion.
The code block style is essentially a quote to a certain text. Readers can use this style to distinguish which text is quoted.
When reading the original code (plain text), only two ` symbols are displayed. This symbol is in half-width form, and combined with half-width spaces, you can make a relatively good prediction of the layout in the plain text case. When actually rendered, the text in the code block style is rendered with a monospaced font. In some styles, the text background becomes gray (This is true on GitHub and the HMCL docs site).
LTCatt, the developer of PCL2, used this style when announcing that their launcher source code was available and compilable. He/she used this pattern to make it clear how to find the Open with Visual Studio option in the GitHub repo homepage. For details, you can directly view a discussion he/she started: Hex-Dragon/PCL2#3910
If there are no other symbols to clarify that a certain text is quoted, readers will easily be dazzled in the dense text, have a bad look and be prone to misreading. The above code block is just one way to make the formatting easier for readers.
Perhaps we can consider using corner brackets commonly used in the CJK region. But in most cases, what most people type using the Chinese input method is likely to be in full-width form, and the typesetting is not easy to control in some cases; while the input of half-width corner brackets is more complicated. I have only seen one team use the half-width form when renaming files.
Maybe also consider English-style quotes (full width). However, the rendering effects of full-width format are different in different scenarios. Some fonts are rendered full-width, others half-width. I have seen some people write documents that add half-width spaces around full-width quotes. In this case, changing the scenario (for example, copying the text to another place) will result in too much spacing between the quotation marks and other text.
All in all, I think that if you use the last two quotation marks, typesetting will not be too easy under different scenarios and different writers. Code blocks are simple and easy to use, and typesetting is relatively easy. Of course, I do not own this document, so I need to reach a consensus with your team. I also hope to gain more valuable experience in this kind of discussion.

[Zkitefly]

我觉得可以加
但,我在考虑一个问题,当使用浏览器的全文翻译时那些使用代码块的文本可能会出现排版问题(Google Chrome 倒不会,Microsoft Edge 似乎会),可能对那些看不了中文需要翻译的人来说有点不方便(当然,这个是个小问题)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.