Giter Site home page Giter Site logo

qyxf-sets's People

Contributors

gxf1212 avatar siyuanwu99 avatar xjtu-blacksmith avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

Forkers

michaelguo1204

qyxf-sets's Issues

github is interesting!

github is interesting!
ギトハボがおもしろそう!
社交编程及代码托管网站真好玩!

开发及使用成本太高,拟降低

这是一份「备忘录」,也欢迎路过的同学发表自己的意见。

作为该系列宏集目前的维护者,我深感力不从心。这并不在于如何改进已有问题、开发新功能之类,而在于:

  • 文档维护成本太高。为了改进一小个问题,需要仔细调整整个 dtx 的结构,修改校验和,用 \changes 这样的命令人工记录改动;同时,为了方便大家使用,又需要重新生成手册及 cls 文件。
  • 后继无人。通过这种类似文学编程的方式编写文档,不能说是很困难,但非常缺少中文资料以便于大多数人入门;同时,从目前钱院学辅的人员状况来看,我也暂时找不到人接手此项工作。

另外,即使在仓库及发行版本中已经生成了 cls 文件,该宏包也存在着使用不便的情况。这与开发不便有一定关系;我只能将有限的时间用于处理自己已知的错误,而不能进行比较综合的测试。他人亦难于测试此模板的功能。

Doc/docStrip 的使用是需要一定成本的。经过半年的实践,我认识到,这种成本无法由一个校内社团的业余爱好者们承担;目前,考虑降低这份模板的开发及使用成本,大致的方案是:

  • 不再使用 doc/doctrip 同时开发宏集和撰写文档,并移除无用的 notenotice 模板,专注于资料编排所用的 qyxf-book 模板;
  • 直接编写 cls 文件,并通过代码中的注释、额外的说明文档(Markdown 格式)、demo 等,替代原来不合用的合成文档;
  • 不再使用现在的 LPPL 许可证,改用更宽松者(如 MIT),放宽使用条件,鼓励他人对此模板进行调整、修改。

以上仅是技术方面可以实行的手段。社团方面另有若干工作要做,不表。

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.