标签: readme

我可以以某种方式将文件包含到 mkdocs 中的文件中吗？我不想一次又一次地复制粘贴相同的部分。谢谢

我在我的主分公司开发.我的同事们在他们的个人主要分支中发展 我们将它合并到组织主分支中(这简化了AppVeyor,TravisCI和其他服务的使用,也允许将并行分支专门用于每个开发人员的文档).ReadMe.md的合并是一种痛苦.是否有可能:

• 不是automerge ReadMe.md文件？
• 使ReadMe.md的部分条件有条件(例如,如果ReadMe在B/master中执行此操作,如果它在B/master中执行此操作)？

使用 GitHub 的基于 Web 的界面，我无法弄清楚如何为项目的 README 文件指定备用路径/文件名。

创建新的 README 时，Web 界面确实让我可以选择使用我想要的任意路径或文件名，但我选择的文件不会用作项目级 README。我希望它在用户访问项目页面时显示。

在具有所有此类/README.md项目的所有此类 README 文件的模块或扩展（例如 Magento 1 模块）的项目的上下文中，它们将在最终合并中全部被覆盖，因此应使用备用路径或文件名（例如/docs/projectname/README.md或/projectname.md）。

如何以将该文件指定为默认自述文件的方式执行此操作？

在我的Readme.MD降价文件中，我想创建目录（用于 Github）。[TOC]（由 Typora 生成）未显示在 Github 上。它显示为[TOC]. 我的一些标题包含点或逗号等字符。有没有办法链接到这些标题？

我尝试了几乎所有我认为的东西，例如：[app.js File](#app.js-file), [app.js File](#app-js-file), [app.js](#app--js-file), [app.js](#app\.js-file), [app.js](#appjs-file)。什么都行不通。

下面是一个例子：

Table of contents:
[app.js](#app-js)
[script.js](#script.js)
[One, two, three](#one,-two,-three)

# app.js File
Some text

# script.js File
Some text

# One, two, three
Some text

PS 有些人在谈论创建 HTML 锚点（命名），但是你如何/在你的 MD 文件中在哪里编写它们（如果它是解决方案）。你能解释一下吗（我在互联网上找不到任何解决方案）。

我使用“readme.md”创建了我的存储库，但标准是“README.md”。有谁知道如何重命名为大写吗？

我尝试过仅重命名，但没有成功。

编辑：我在Linux上

提前致谢。

我想添加一个在搜索 Github 主题时显示的图像横幅（因为 repo 很突出）。

我想做这样的事情

目前，我正在 readme.md 文件的顶部添加图像，但它不起作用。

<h1 align="center">
 <img src="image-url-here" />
</h1>

# rest of readme ..

我该怎么做？

我编写了简单的服务器，其中golang女巫应该返回一个包含堆栈溢出统计信息的 SVG。只要它在浏览器或 Postman 中测试来自我的服务器的响应，一切都会正常工作，但是当我尝试将此响应固定为 github 中的图像时，README.md我从 Stack API 提供的图像无法正确显示。这是一个示例：

通过浏览器：

并将结果README.md存档（此红线仅用于强调）

Github 是否会屏蔽其他来源的图片？在我的例子中，图像 URL 表明该照片托管在 Facebook 服务器上， href="https://graph.facebook.com/1432867793574670/picture?type=large 但这真的重要吗？

有什么办法可以解决这个问题并正确显示该图像吗？也许有一些 svg 图像标签属性可以帮助解决这个问题？

链接到发生此问题的存储库：https ://github.com/kubo550/stack-stats

这是我从服务器响应中得到的确切 svg 代码：

<svg data-testUserId="14513625" width="158" height="47" viewBox="0 0 158 47" fill="none"
     xmlns="http://www.w3.org/2000/svg">
    <rect width="158" height="47" fill="#2D2D2D"/>

        <!-- this is the problematic line -->
    <image x="16" y="10" href="https://graph.facebook.com/1432867793574670/picture?type=large" height="24" width="24"/>
    
    <text x="64" y="23" font-weight="bold" fill="#C4CCBC" font-family="Arial" font-size="12"
          text-anchor="middle" dominant-baseline="middle">1,707
    </text>
    <circle text-anchor="middle" dominant-baseline="middle" cx="90" cy="23" r="3" fill="#F0B400"/>
    <text x="100" …

如何确保shields.io徽章指向该网站，并使用参考样式的降价链接来做到这一点。

这很好用

[![](https://img.shields.io/badge/code%20style-black-black.svg?style=for-the-badge&labelColor=gray)][http://github.com/psf/black]

[][http://github.com/psf/black]

这不起作用

![]([black-shield])[black]

[black]: http://github.com/psf/black
[black-shield]: https://img.shields.io/badge/code%20style-black-black.svg?style=for-the-badge&labelColor=gray

我知道如何在 类似的 文件中 创建Markdown 表README.mdGithub

|   FREEZ   |   col1    |   col2    |   col3    |   col4    |
|   ----    |   ----    |   ----    |   ----    |   ----    |
|   row1    |   ----    |   ----    |   ----    |   ----    |
|   row2    |   ----    |   ----    |   ----    |   ----    |
|   row3    |   ----    |   ----    |   ----    |   ----    |
|   row4    |   ----    |   ----    |   ----    |   ----    |

无论如何，我的问题
如何冻结列/行
因此滚动不会移动冻结的单元格

有什么方法可以证明自述文件中的文本合理吗？我尝试过

<div dir="rtl">
    text...
</div>

和

<div dir="ltr">
    text...
</div>

并且有效，但标签justify不存在。我检查过的其他解决方案是通过这个问题

如何在 Markdown 中右对齐和右对齐？

<div style="text-align: justify">
    text
</div>

但两者都不起作用...有什么方法可以执行它吗？