Rebuilding the wiki

[valoq]

The wiki is quite the mess at the moment, with a lot of outdated scripts and more importantly, very had to navigate.

I would propose a complete overhaul of the wiki pages, starting with moving all of the current content to a archive subpage to ensure no content is lost.

Then we should start with a new structure that could look something like this:

Start (HOME) -> With an index and links to the subpages including short summaries of whats to find there
Tutorial - > the first subpage. Most of the content looks quite ok here.
Configuration -> common additions to lfrc, with subpages: preview, Integrations, Tips, mailcap, Ranger, colors and Icons
Troubleshoot
Packages (maybe this should be in a subpage? its not that relevant for most users)
FAQ

The updater script is something I would remove entirely but that's my opinion. These kinds of handwritten update scripts are something I find very questionable, especially for something like a small static binary.

The main objective for me would be to ensure new users are not overwhelmed with the many options and pages in the wiki, but rather find the relevant information and only the advanced things when they are looking into that direction anyway.

Any feedback and alternative ideas?

[CatsDeservePets]

I pretty much agree with your points.

For what it's worth, here is what I came up with when trying to rebuild the wiki (FAQ) myself:

Details

How do -print-selection/-selection-path work?

Both flags turn lf into a file picker:

1. Select the files you want.
2. Confirm the selection by opening any file.

lf then exits and returns the selected paths. -print-selection prints them to stdout, -selection-path <path> writes them to the given file.

If you quit lf without confirming, the selection is discarded.

How to change your shells directory using lf?

For security reasons, regular programs like lf can't change your shell's working directory.

A common workaround is printing or writing the last directory on exit and letting the shell cd into it. lf exposes the flags -print-last-dir and -last-dir-path for this purpose.

You can use one of the example lfcd wrapper shell scripts provided here:
https://github.com/gokcehan/lf/tree/master/etc

Why don't my icons show up correctly?

Make sure the following things are true:

• You put set icons into your lfrc.
• You are using a nerd font and your terminal supports it (not needed when using emojis or 'normal' characters)

Tip: When using custom icons, make sure to put slashes (/) after directory names (even on Windows).