Raneto
Raneto copied to clipboard
filename rules
can't have _, -, especially . in filenames, for example: myfile.md is fine. my_file.md, my-file.md, my.file.md are not handled/displayed correctly.
thanks laoshaw for reporting this issue.
I tested what you mentioned. everything works fine with "-" and "_" but it's not working for "." actually because the url cannot contain ".". I'm going to resolve the issue with the names containing "." but please give me more information about your my_file.md and my-file.md . as you can see Raneto inside its example directory have an example of the naming with "-" : what-is-raneto.md and you can check if it works fine for you.
that was tested against the master branch, it happens to be my files with - and _ can not be displayed, then I realized(see another issue) some random files are not shown up either, so for this issue the filename contains extra "." is the real one, i.e. I can't have a file such as my.file.md. Thanks.
ok I looked into the code and it's not regular but we can shim "." in the name of the file with replacing it with another character but it's just a shim. the best practice would be not having "." in names.
so if you agree this issue could be obsolete as we can continue with #141
Is this topic still in work? I want to document my IT infrastructure and name a host with DNS name like MYSERVER.mydomain.local - but that fails because of the dot problem here.
For be it would be really ugly to change all my file names (i want to migrate my existing markdown-based documentation to Raneto).
Sure you can have . in the paths and urls. https://stackoverflow.com/questions/6777274/can-urls-contain-dots-in-the-path-part Here is even someone asking that same question on stackoverflow, and example of spring url having it. This is a big problem just like leo90skk said - sometimes renaming all of your infrastructure for a non-required limitation may make raneto unusable for some basic use cases.
This is for directories AND files. Luckily I'm generating my own files but I could see how this would be a deal breaker if I had a bunch of pre-existing files.
I also think it would be nice if Raneto allow dots in folders and file names. My current docs uses a bunch of dots on folder and file names. I renamed them, but I would prefer not to have to. This issue will probably affect many people migrating to Raneto.