So, I started to use orgmode for writing the documentation for my latest software project. This means, that I have code blocks and lots of special characters in my document. I will have to export this whole file to LaTex/pdf, so my colleague can bind it into his project documentation and this is exactly where my problems are. First of all: how can I turn of the need to manually stop the code execution for code blocks when exporting? I have the single line src_bash{} blocks but also the multiline versions:

#+begin_src bash :
#code
#+ends_src

The next thing is, that my function names include underscores, which in orgmode translates to making the following text lowercase. I tried using \ to escape it, but that only breaks it in a new way and I seriously cant comprehend how this so called zero width space is supposed to be used.

  • flamingos-cant (hopepunk arc)@feddit.uk
    link
    fedilink
    English
    arrow-up
    1
    ·
    1 day ago

    First of all: how can I turn of the need to manually stop the code execution for code blocks when exporting

    From the docs:

    You can prevent Org from evaluating code blocks for speed or security reasons:

    • To speed up export, use the header argument ‘:eval never-export’
    • For greater security, set the org-export-use-babel variable to nil, but understand that header arguments will have no effect in this case.

    The next thing is, that my function names include underscores, which in orgmode translates to making the following text lowercase.

    Do you mean subscript, like HELLOWORLD? Also from the docs:

    If you write a text where the underscore is often used in a different context, Org’s convention to always interpret these as subscripts can get in your way. Configure the variable org-use-sub-superscripts and/or org-export-with-sub-superscripts to change this convention. For example, when setting these variables to {}, ‘a_b’ is not displayed/exported as a subscript, but ‘a_{b}’ is.

    • da_cow (she/her)@feddit.orgOP
      link
      fedilink
      arrow-up
      1
      ·
      1 day ago

      For greater security, set the org-export-use-babel variable to nil, but understand that header arguments will have no effect in this case.

      That worked perfectly.

      Do you mean subscript, like HELLOWORLD? Also from the docs:

      Thats exactly what it is. I setted both of the mentioned variable to "{}" like this:

      (setq org-use-sub-superscripts "{}"
      
            org-export-with-superscripts "{}")
      

      however, when I write something like this: log_{critical}_{error}, it gets rendered like this: logcriticalerror

      • flamingos-cant (hopepunk arc)@feddit.uk
        link
        fedilink
        English
        arrow-up
        2
        ·
        edit-2
        1 day ago

        You need to use a symbol, not a string:

        (setq org-export-with-sub-superscripts '{}
              org-use-sub-superscripts '{})
        

        write something like this: log_{critical}_{error}

        That’s what you’d need to write to have subscript, with the above set:

        • log_critical => log_critical
        • log_{critical} => logcritical

        Edit: org-export-with-superscripts => org-export-with-sub-superscripts

        • da_cow (she/her)@feddit.orgOP
          link
          fedilink
          arrow-up
          1
          ·
          1 day ago

          So I have set them like this:

          (setq org-use-sub-superscripts '{}
          
                org-export-with-superscripts '{})
          

          and it still does not render correctly. Writing log_critical and log_{critical} gets rendered as logcritical

          • flamingos-cant (hopepunk arc)@feddit.uk
            link
            fedilink
            English
            arrow-up
            2
            ·
            edit-2
            1 day ago

            Weird, are they getting overridden by something else in your config (a package or something). In an org-mode buffer, what’s the output of C-h v org-export-with-sub-superscripts?

            Edit: worked out the issues, I wrote the one of the variable names wrong, it should be org-export-with-sub-superscripts not org-export-with-superscripts

            • da_cow (she/her)@feddit.orgOP
              link
              fedilink
              arrow-up
              1
              ·
              1 day ago

              That fixed it. :3

              May I ask you something else? Do you know how I can configure the layout of tables in Orgmode? Currently my table looks like this:

              What I am missing is a separator between each column. I tried out various things through the LaTex attributes as it has been described here, but most stuff either broke my caption or didnt change anything at all about the table. I have not configured my table anything beyond giving it a caption.