datalad-handbook/docs/basics/topic/hidden-extensions.rst
Michael Hanke 05d1af4a10 Move windows-wit box content into dedicated file
The main goal is to trim the diff to the print version again, where
content was moved and taken out of containers. This makes merged
conflict-ladden and painful. With this approach, any content change
would happen in the dedicated file, which can be used for boxes
and sections alike. Associated index items must stay outside,
because they are declared on the container.

This changeset is complete, the rest will happen in the print-version
branch.
2023-11-06 16:42:30 +01:00

10 lines
1.1 KiB
ReStructuredText

By default, Windows does not show common file extensions when you view directory contents with a file explorer.
Instead, it only displays the base of the file name and indicates the file type with the display icon.
You can see if this is the case for you, too, by opening the ``books\`` directory in a file explorer, and checking if the file extension (``.pdf``) is a part of the file name displayed underneath its PDF icon.
Hidden file extensions can be a confusing source of errors, because some Windows editors (for example, Notepad) automatically add a ``.txt`` extension to your files -- when you save the script above under the name ``list_titles.sh``, your editor may add an extension (``list_titles.sh.txt``), and the file explorer displays your file as ``list_titles.sh`` (hiding the ``.txt`` extension).
To prevent confusion, configure the file explorer to always show you the file extension.
For this, open the Explorer, click on the "View" tab, and tick the box "File name extensions".
Beyond this, double check the correct naming of your file, ideally in the terminal.