Remove superfluous note names

Perhaps one reasoning for the h1/…/h6 scheme in HTML is that in HTML/markdown documents are typically part of larger sites (or Joplin notebooks), where each page/note is a section. Then the “one“ in h1 makes sense despite having to use it for what is in effect a title for a page (which itself is a section of the site).

I don't get what's the fuss about - just fork the source from Github, modify it to your heart's content(it's fun, trust me) and then use it.
If you really have got the hang of it then publish it as Joplin NI. :wink:

Please do NOT implement this suggestion as this is dreadful idea. I do not want the first line of the note to be the name of the note. I want to be able to name my notes based on the overall subject matter or content, not on the first line. This is like removing the subject field from an email.

6 Likes

I’m reconsidering, but just to understand, if you print a note, do you print the title ?

As far as I understood, there seems to be two ways people prefer to write their notes - the heading as a part of their note or as something distinct from the note. If the title bar is removed, the people of the second camp will be in trouble. Putting an option to toggle it might be a good idea but may not be so simple from a layout POV and perhaps has some more technical limitations too.
As for the printing issue, can it not be fixed with CSS in the stylesheet?

1 Like

Yes, the title is currently added to the printout/PDF. But this is something that we can fix by either using a class for that element so that you can remove it with CSS or an option in settings. (But I think that Laurent tries to minimize the number of settings.)

I can do either way, depending on Laurent’s approval.

6 Likes

I use Joplin to store legal documents i.e. court transcripts. They need to be an exact copy of what has been published; they should not be amended. The document does NOT necessarily contain (at the top or elsewhere) a suitable title. Your suggestion means that I have to add an additional line to the top of the document, which alters the original so that I can have a meaningful title. That is nonsensical.

3 Likes

This is definitely your opinion

If you can add a class that would indeed be a good start, and an easy way to allow customising the pdf or printout.

Yep, I was looking for the code I wrote a while back to fix the title/toc problem, but it’s no longer there. Refactoring removed the file and added a new service and I am currently trying to find where the title is added to the printout. Hmm, the code base is getting bigger…

Right, it got moved InteropService_Exporter_Html when I refactored to support HTML export, and so that PDF and print can all be based on the HTML export service.

And actually I see the title already has a class “exported-note-title” so it should be possible to hide it or customise it already.

1 Like

Is there a full list of css classes somewhere? I have modified my layout in userstyle.css but I have always based it on hints I have got from here. If I could find a full list then I could customise my theme more confidently.

Cheers.

1 Like

There isn’t a full list anywhere, but if you toggle development tools you can use the debug selector to click on any element and be given all the info about it (html element name, CSS class, etc.). Additionally you can change the CSS properties using the debug tools to preview how things will look. This is the best method for tweaking CSS with Joplin IMO.

The selector tool is in the very top left corner of the debug window and it looks like a mouse pointer clicking on a square.

Edit: more info

For Jekyll and similar markdown-to-static-webpage tools, the de facto standard is to have the page title set using YAML-compatible metadata. This is also the place for other document metadata, such as a published date and document tags. For example:

---
title: The Ministry of Silly Walks
date: 1970-09-15
tags:
  - Mr. Putey
  - Mr. Teabag
  - cult classics
  - John Cleese
---

# Scene One

A man walks very peculiarly to his workplace, The Ministry of Silly Walks.

# Scene Two

The man rejects a new silly walk proposed to him.

Actual rendering of this depends on page layouts, but as most preexisting guidelines for HTML strongly encourage only a single H1 per page, it will usually involve rendering the title as an H1 and headings starting at # as H2 and down.

1 Like

I would love if this data was additionally stored in the markdown as yaml.

I personally like the simplicity of the app showing things like a “title” input box, but would love if the date, tags, title, alarms, etc were all available on export and when editing in an external editor. That seems like that would give a lot of power and longevity to the system! Could even be a setting, where you can either show or hide the yaml in the markdown file.

Just for reference…

Here’s the required css (in userstyle.css) to not print the document title (or when creating a PDF):

@media print {

	.exported-note-title {
		display: none !important;
	}

}

Let me just add my voice to the "I prefer the current separation between title and content" side of things.

For some of my notes, the title is identical to the first header; for most of them, it is not. In my mental model, the title is similar to a filename (and helps me find the note), but I do not need the title replicated as the first header of the note.

As this thread seems to be quite opinionated at times, let me proactively declare that I'm fully aware that other use-cases can differ and that I can fully understand that. But I'd like to keep my workflow nevertheless :sunglasses:

1 Like

This sounds like a contradiction to me. Keep in mind that it will be superfluous if it is always kept in sync. Right now the note title is not the same as the first line of the note.

To me it seemed the reason why joplin used the first line to create a title the first time, is because setting the first line as a title is more helpful than “Untitled note” for example.

Compare it to a word document. Enter some text, save it. It will suggest using the first line as the file name, but you are free to change it. If you edit the document later, it will (obviously) not change the file name.

Some people might put a title at the top of every document that matches the file name. Maybe you’re one of those people. However, everyone’s workflow is different and many people (including myself) like to have a title (“file name”) separate from the note body.

4 Likes

Yes, I’m just imagining the nightmare of finding that all my notes have synced the first line to the title, removing all of the original titles and leaving them unintelligible to me.

Although I suppose that wouldn’t necessarily have to happen for the first line/title syncing to happen. As someone else mentioned, a toggle might be the best option.