texmacs / notes Goto Github PK

View Code? Open in Web Editor NEW

23.0 6.0 13.0 37.55 MB

Notes about TeXmacs

Home Page: https://texmacs.github.io/notes/

License: GNU General Public License v3.0

Tcl 99.80% TypeScript 0.03% CSS 0.09% Scheme 0.08% HTML 0.01% JavaScript 0.01%

texmacs

notes's Introduction

GNU TeXmacs

GNU TeXmacs is a free wysiwyw (what you see is what you want) editing platform with special features for scientists. The software aims to provide a unified and user friendly framework for editing structured documents with different types of content (text, graphics, mathematics, interactive content, etc.). The rendering engine uses high-quality typesetting algorithms so as to produce professionally looking documents, which can either be printed out or presented from a laptop.

The software includes a text editor with support for mathematical formulas, a small technical picture editor and a tool for making presentations from a laptop. Moreover, TeXmacs can be used as an interface for many external systems for computer algebra, numerical analysis, statistics, etc. New presentation styles can be written by the user and new features can be added to the editor using the Scheme extension language. A native spreadsheet and tools for collaborative authoring are planned for later.

TeXmacs runs on all major Unix platforms and Windows. Documents can be saved in TeXmacs, Xml or Scheme format and printed as Postscript or Pdf files. Converters exist for TeX/LaTeX and Html/Mathml.

Documentation

GNU TeXmacs is self-documented. You may browse the manual in the Help menu or browse the online one.

For developer, see this to compile the project.

Contributing

Please report any new bugs and suggestions to us. It is also possible to subscribe to the [email protected] mailing list in order to get or give help from or to other TeXmacs users.

You may contribute patches for TeXmacs using the patch manager on Savannah or using the pull request on Github. Since we are using SVN on Savannah, PRs won't be directly accepted on Github. We will git apply the patch into SVN repo if the PR is accepted. And we will close the PR and change the title to [SVN] xxx after applying the PR.

notes's People

Contributors

Stargazers

Watchers

Forkers

pireddag xif-fr da-liii ingolfschaefer nerd-qp he-ruisi jqfeld woutersj edgarsllow wosined fp4code zfzhong jackyansongli

notes's Issues

The blog title in every page?

It might be good that every page has "A TeXmacs blog" in its header.

Invitations to write

I have ideas on whom to ask to write something for the blog. Maybe I can send them via email.

Travis build to check the file name under `src/`

Implement an RSS feed and improve syndacation

We already have an Atom feed generator which creates the Atom feed during the update phase (see the script notes-tools.scm). It would be nice to also generate an RSS feed and in general to make more robust the script.

how to use this repo as a blog template

Dear,

I'm trying to use this notes repository as a blog template.
I went through the "contribution-guide.tm" and was able to generate HTML files locally.
But I did not figure out how "update-website" and "notes-tools.scm" were used.
It seems that Scheme functions in "notes-tools.scm" are to take care of the files "list-articles.tm" and "notes.atom".

Any hints?
Thank you very much,
Hongying

The contribution part of the README can be maintained in a github flavor

See https://github.com/texmacs/notes/community

Couldn't concretize tuple

When I run this blog template on Windows, I met the following problem.

how to generate feed entry for nonlatin document

Hi there, I'd like to use this repo as a starting point for my blog, part of which is in Chinese.
However the title and summary of these documents in the Atom feed generated are garbled like this:

<entry>
    <title><#9E3F><#722A><#30FB>2021<#5E74>8<#6708></title>
    <link rel="alternate" type="text/html" hreflang="en" href="http://texmacs.github.io/notes/docs/record-2021-08.html"/>
    <id>texmacs.github.io/notes/record-2021-08.tm:2021-12-26T12:23:48Z</id>
    <updated>2021-12-26T12:23:48Z</updated>
    <published>2021-12-26T12:23:48Z</published>
    <summary><document><#300A><#4E2D><#56FD><#8BDD><#300B></document></summary>
  </entry>

Not so familiar with lisp, so I'm wondering if there's a function that can decode these.

Output of update-website

The article list, if I run update-website, lists the time-zone as GMT.

This is what I understand right now.
Guile's gmtime calls the C gmtime function. I have looked into the C sources for the time library, and I understood this: gmtime calls __tz_convert with use_localtime set to 0; then the following assignment is executed: tp->tm_zone = "GMT";

How is it that in the article list in the website time zones are UTC?

Can't open "https://texmacs.github.io/notes/"

Recently, I can not open the website and https://texmacs.github.io/notes/. I have forked the whole project and I have setted up my own website. But in the past few days, I can not open any website including the official. What happened?
Hope someone can give me an answer! Thanks!

Article modification dates

When running update-website, the article modification date is the file modification date on my computer. If I were to clone the repository now, all the articles would have "now" as modification date.
Updating my fork to the texmacs/notes parent one, there are a few articles which are taking up "today" as modification date.
Do you have any suggestion on how to get their modification date to match the ones in the repository?

Update
With a quick Internet search I found statements that git updates modification times by design. We could write a script that overrides this behaviour for the posts. I do not follow all of the details, but this is an example

At a quick look of what its author says about it, it seems written with care):
https://github.com/MestreLion/git-tools
https://stackoverflow.com/questions/1964470/whats-the-equivalent-of-use-commit-times-for-git/13284229#13284229

and (cited in the previous link)
https://repo.or.cz/w/metastore.git

Not compatible with Mogan

Hi, I have used this package to build my personal blog for two years. However, as I switched from TeXmacs to Mogan this year, this package is invalid for MacOS using Mogan.

I just added the note.ts files into ~/.Xmacs/styles. The note style shows up in the toolbar. However, all the commands fails to work.

Copying code from the posts

Formatting of the code is not preserved when copy-pasting from a blog post to the TeXmacs editor. There are line breaks where they should not be and the copied text is wrapped inside a "code" macro.
In order to get the code---with the right line breaks---into TeXmacs one has to "paste from verbatim". Is it possible to change something in the html so that this does not happen, or should one change something in TeXmacs (the additional line breaks might be a bug) or should we add a note about this so that people know they should "paste from verbatim"?