Coder Social home page Coder Social logo

Comments (14)

tumashu avatar tumashu commented on August 18, 2024

我真正维护的是 elisp 文件 Commentary: 部分,这个文件是用 el2markdown 自动生成的。
手动让两份文档保持一致太麻烦了,所以:我在等 el2markdown 添加 post-hook 功能。。。。

from pyim.

tumashu avatar tumashu commented on August 18, 2024

同学,忍忍吧。。。。。

from pyim.

xuchunyang avatar xuchunyang commented on August 18, 2024

我知道 README.md 是自动生成的。我的意思是现在需要的临时解决办法是:手动把 README.md 中的多余的换行先去掉,而不是先把这个问题先放着。

你只需要维护 elisp 文件中文档,每次只有更新了 Commentary 部分,才需要生成 README.md ,这时才需要手动修改 README.md。

from pyim.

xuchunyang avatar xuchunyang commented on August 18, 2024

我在等 el2markdown 添加 post-hook 功能

el2markdown 主要功能无非就是把 elisp 中相关部分的注释符号去掉,我并不觉得还有什么功能需要添加。

from pyim.

tumashu avatar tumashu commented on August 18, 2024

哥们还是再忍忍吧,我觉得文档还是 org-mode 写比较好,但一开始我偷懒,发现el2markdown很省事。。。 等我想好怎么组织文档后,是转到org吧,markdown的功能太弱了。

from pyim.

tumashu avatar tumashu commented on August 18, 2024

lentic 是一个比较有意思的东东。

from pyim.

xuchunyang avatar xuchunyang commented on August 18, 2024

哥们还是再忍忍吧,我觉得文档还是 org-mode 写比较好,但一开始我偷懒,发现el2markdown很省事。。。 等我想好怎么组织文档后,是转到org吧,markdown的功能太弱了。

org 和 Markdown 有同样的问题,只要你使用中文时还要遵守最长行的限制,这个问题会一直存在。

org-readme 看起来类似于 el2markdown。

from pyim.

tumashu avatar tumashu commented on August 18, 2024

org-mode 有强大的 export 系统,我完全可以写一个export filter 来处理这个事情。

from pyim.

tumashu avatar tumashu commented on August 18, 2024

把 chinese-pyim 的开发模式改成 org-mode 方式的 文学编程? 比较另类的方向。

from pyim.

xuchunyang avatar xuchunyang commented on August 18, 2024

org-mode 有强大的 export 系统,我完全可以写一个export filter 来处理这个事情。

Markdown、Org、reStructuredText 等等在换行问题上没有考虑到中文,是个设计上的问题。目前主流的方法是中文不换行,英文可换可不换。比如我现在正在 Github 上用中文回复你的评论,我是不能觉得这一行太长了就换个行,只要这一段没有写完就不能换(也就是说,中文的一段只能占一行,无论你这行有多长)。而英文就可以随时换个行。

from pyim.

tumashu avatar tumashu commented on August 18, 2024

这个我倒是有所了解,但我还是倾向于换行,而不是一行一段,因为如果一行一段,使用 diff 进行码审核时太痛苦了。 所以我 个人认为 一段一行的中文文档是不能当作主要维护文档的。

from pyim.

xuchunyang avatar xuchunyang commented on August 18, 2024

假如你是想把中文文档以 HTML 的形式呈现(比如此 issue 提到的 README.md),那么多余的换行(空格)是不能接受的。

from pyim.

tumashu avatar tumashu commented on August 18, 2024

我已经使用 org-mode 的文学编程功能 重新组织了代码,现在空格问题应该得到解决了。 这里再次感谢
许兄的大力支持。。。。

from pyim.

xuchunyang avatar xuchunyang commented on August 18, 2024

👍

from pyim.

Related Issues (20)

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.