all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: despen@verizon.net (Dan.Espen)
To: help-gnu-emacs@gnu.org
Subject: Re: I'm looking for a project management system for Emacs
Date: Sun, 30 Mar 2014 16:30:42 -0400	[thread overview]
Message-ID: <ica9c7xwct.fsf@home.home> (raw)
In-Reply-To: mailman.18567.1396206860.10748.help-gnu-emacs@gnu.org

Marcin Borkowski <mbork@wmi.amu.edu.pl> writes:

> Dnia 2014-03-30, o godz. 10:18:40
> despen@verizon.net (Dan.Espen) napisał(a):
>
>> >> Nope, big Gnumake fan here.
>> >> Any directory/project I do work in is going to have Makefile(s).
>> >
>> > Well, then I deduce that you are not a heavy LaTeX user.  (Am I
>> > right, dear Watson? ;) )  The problem is that the make model (using
>> > timestamps) is a bit too simplistic for LaTeX: due to the way
>> > references (& friends) work, the .aux file basically depends on
>> > itself, but only if it contains a line saying
>> 
>> Right.  Latex is for printing isn't it?
>
> Rather typesetting, usually to a pdf file (at least nowadays).  Of
> course, most of the time this means that something will eventually find
> its way to a dead tree.  (OTOH, there /are/ TeX-based engines which can
> output HTML/XML, too.)
>
>> I do a lot of documentation writing.
>> But HTML/CSS (and Makefiles) are my weapon of choice.
>
> This is a very good choice, /if/ you do not aim for high typographical
> quality and/or atypical applications (typesetting of chemical
> formulae, musical notation, dictionaries etc.).

Yep, I can care less about paper, but the display quality is to
some extent a function of the browser.

> Out of curiosity: are there /any/ HTML/CSS rendering solutions
> (browsers, ebook readers etc.) which handle breaking paragraphs into
> lines in an aesthetically satisfactory way (i.e., employ the
> Knuth-Plass algorithm, for instance)?

Well, browsers do re-flow when you change window size.

Hmm, Google says there are some Javascript
implementations of Knuth-Plass.

>> I have rules for content generation (like a TOC), uploading, thumbnail
>> creation, packaging...
>
> Do you aim for online browsing only, or for a printed version, too?  If
> the latter, how do you handle the problem of (potentially) unstable
> forward page references?

When you identify your CSS there is a "media" option.
I do most of my work for browsing, but for the few people that
print, I do have a "print" CSS.

As for forward references, I just do "See X below".  If you print,
you've got to search.  If you are browsing, "See below" is a link.

I've adopted a convention so that headings point back to the next
higher level heading.  So, H2 points to the enclosing H1,
H3 points to it's parent H2, and so on.

It makes navigating, even big documents a breeze.

Each TOC only goes one level deep.
So the main TOC references the H1 headings.
If there are a few H2 headings, there is a nested TOC.

At the same time, I use DIVs to indent heading levels a little more.
This makes up for not having numbered sections.

I especially like the "Change History" section offering links to
the changes.  Someone that's just looking for new stuff gets there
pretty quickly.

A really neat HTML feature is a Javascript package I found that
makes <table>s sortable.  It's so neat to put a table into
a document and know the user can sort it on any of the columns.

I've been advocating for dumping Word and PDFs but people are
slow to change, so I lead by example.

-- 
Dan Espen


  parent reply	other threads:[~2014-03-30 20:30 UTC|newest]

Thread overview: 21+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <mailman.18471.1396076481.10748.help-gnu-emacs@gnu.org>
2014-03-29 17:11 ` I'm looking for a project management system for Emacs Dan.Espen
2014-03-29 18:03   ` Marcin Borkowski
     [not found]   ` <mailman.18509.1396116232.10748.help-gnu-emacs@gnu.org>
2014-03-30  4:29     ` Dan.Espen
2014-03-30  8:06       ` Marcin Borkowski
     [not found]       ` <mailman.18551.1396166787.10748.help-gnu-emacs@gnu.org>
2014-03-30 14:18         ` Dan.Espen
2014-03-30 19:14           ` Marcin Borkowski
2014-03-31 17:34             ` hubert
     [not found]           ` <mailman.18567.1396206860.10748.help-gnu-emacs@gnu.org>
2014-03-30 20:30             ` Dan.Espen [this message]
2014-03-30 21:02               ` Marcin Borkowski
2014-03-29  6:56 Marcin Borkowski
2014-03-29  9:35 ` Thorsten Jolitz
2014-03-29 18:12   ` Marcin Borkowski
2014-03-29 15:22 ` Drew Adams
2014-03-29 18:21   ` Marcin Borkowski
2014-03-29 18:24     ` Jai Dayal
2014-03-29 19:02     ` Drew Adams
2014-04-02 12:31     ` lee
2014-04-10 12:12       ` Jude DaShiell
2014-04-03  1:38     ` Robert Thorpe
2014-04-03 13:14       ` Alex Bennée
2014-03-29 20:45   ` Renato

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=ica9c7xwct.fsf@home.home \
    --to=despen@verizon.net \
    --cc=help-gnu-emacs@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.