tutor: raw text not shown while editing element

[goyalyashpal]

Problem

wherever some data from syntax is hidden in the rendered output, it becomes hard to edit that. it's like editing with a blindfold.

• * asterisks disappear while trying to type them - it becomes impossible to know where to end them or where there extent lies
• heading labels, the label is hidden: # title {label}
• links, target is hidden: [label](target)

neovim/runtime/tutor/tutor.tutor

Lines 82 to 83 in e016f5b

	This is a header with a label
	# This is a header with a label {*label*}

neovim/runtime/tutor/tutor.tutor

Lines 108 to 109 in e016f5b

	A link to help for the 'breakindent' option
	A link to help for the ['breakindent']('breakindent') option

Steps to reproduce

1. nvim
2. :e <nvim-dir>/share/nvim/runtime/tutor/tutor.tutor
3. :let g:tutor_debug = 1 (as instructed at 22gg)
4. 82gg or 108gg
5. try to add a heading label or link target:
   • observe that the label or target becomes hidden; and it's very hard to edit them

Expected behavior

while editing an element, it should be fully exposed in its raw form.
many markdown editors do this like typora

edit: this showed up by entering unneeded dangling asterisks
infact, i don't know how, but nvim inside the :Tutor, i did actually saw the underlying markup when editing an element accidently. but i can't figure it out how did i do that.

Neovim version (nvim -v)

NVIM v0.9.5

Vim (not Nvim) behaves the same?

not applicable

Operating system/version

windows 10.0.19045 N/A Build 19045

Terminal name/version

mintty 3.7.1 (x86_64-pc-msys)

$TERM environment variable

xterm

Installation

in msys2 mingw-w64-x86_64-neovim pkg via command: pacboy -S neovim:x

[goyalyashpal]

jump to 0:17

mintty_T4HCPqbKie.mp4

[justinmk]

Thanks for the report. Can you try the development version?

• The Releases page has pre-built archives for Linux/Windows/macOS.
• Check :version to confirm that you are using the latest version.

[justinmk]

yeah, it is the latest version. 😃

by "latest" I mean the 0.10 dev version which I specifically mentioned. I linked to prebuilt binaries that you can download, you don't need scoop.

[skepticspriggan]

The conceallevel should be 0 according to the filetype plugin after enabling debug mode by following the instructions in the tutor.tutor file. However, :set conceallevel? shows the conceallevel actually remains at 2.

[goyalyashpal]

bug reproduced on latest dev too.
and as shared by @skepticspriggan above, this has to do with the conceallevel setting indeed.

i am thinking smth like conceal_while_editing or conceal_on_cursor setting should be there which defaults to off.
the name is kept starting with "conceal" so that users can find the related ones better together

:version
NVIM v0.10.0-dev-2801+g75b80516d
Build type: RelWithDebInfo
LuaJIT 2.1.1710088188
Run ":verbose version" for more info

[listout]

I'm guessing that the logic in the lines are not being sourced properly or after not sourced after entering :Tutor tutor? As the values of buftype and concealcursor remains unaffected as well.

However if you do :let g:tutor_debug = 1 before :Tutor tutor everything looks as intended.

[zeertzjq]

I don't think this is a bug. As mentioned in the tutor, this only works if you edit the tutor after setting g:tutor_debug:

First, you'll need to enable "debug" mode
~~~ cmd
    :let g:tutor_debug = 1
~~~
This will allow saving changes to the tutor files and will disable conceals, so
you can more easily check your changes.

After this, create a new .tutor file (we will be practicing on this very file, so you
don't need to do this now):
~~~ cmd
    :e new-tutorial.tutor