emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed

* Drupal syntax on html-export for image links
@ 2012-05-24  4:55 William Crandall
  2012-05-24  9:01 ` Bastien
  0 siblings, 1 reply; 7+ messages in thread
From: William Crandall @ 2012-05-24  4:55 UTC (permalink / raw)
  To: emacs-orgmode

[-- Attachment #1: Type: text/plain, Size: 1318 bytes --]

Hello,

I'm drafting pages for publication on a Drupal website.

I've set up a draft-review cycle using Org-mode and some
simplified CSS, for a light-weight type-and-read process.

When I'm happy with the text, I'd like to cut-and-paste
from the generated html output directly into Drupal.

Links to external http files work fine, but image links
(and internal links) are confounding me.

--------------------------------------------------

Drupal inline image syntax is:

  <img src="/sites/default/files/images/BC.png" alt="BC">

Default Org-mode html-export, for  [[/sites/a.png]]  seems to be:

  <img src="file://g:/sites/a.png"  alt="file://g:/sites/a.png" />


Which really won't do. Before hauling out my wheel-creation
tools, has anyone created a "Drupal-link type" for Org-mode?
Or some other solution?

--------------------------------------------------

I found one Drupal thread in the archives:
http://lists.gnu.org/archive/html/emacs-orgmode/2009-11/msg00473.html

But I don't need or want to "push the button" and publish.
I'd just like to modify the html-export output for images.
(And then adapt that to internal links.)

--------------------------------------------------

Thanks for any suggestions or references.
And for Org-mode, which is great!

-BC

Org-mode: 7.8.09
Emacs: 24.1.50.1
Windows 7

[-- Attachment #2: Type: text/html, Size: 5210 bytes --]

^ permalink raw reply	[flat|nested] 7+ messages in thread

• * Re: Drupal syntax on html-export for image links
    2012-05-24  4:55 Drupal syntax on html-export for image links William Crandall
  @ 2012-05-24  9:01 ` Bastien
    2012-05-27  4:43   ` William Crandall
    0 siblings, 1 reply; 7+ messages in thread
  From: Bastien @ 2012-05-24  9:01 UTC (permalink / raw)
    To: William Crandall; +Cc: emacs-orgmode
  
  Hi William,
  
  William Crandall <bc3141592@gmail.com> writes:
  
  > Drupal inline image syntax is:
  >
  >   <img src="/sites/default/files/images/BC.png" alt="BC">
  >
  > Default Org-mode html-export, for  [[/sites/a.png]]  seems to be:
  >
  >   <img src="file://g:/sites/a.png"  alt="file://g:/sites/a.png" />
  
  Nicolas export engine does it right :
  
    <img src="/sites/a.png"  alt="a.png"/>
  
  To use it, please pull from the git master repository then
  
  - add the "contrib/" directory to your load-path
  - (require 'org-export)
  - M-x org-export-dispatch h
  
  HTH,
  
  -- 
   Bastien
  
  ^ permalink raw reply	[flat|nested] 7+ messages in thread

• • * Re: Drupal syntax on html-export for image links
      2012-05-24  9:01 ` Bastien
    @ 2012-05-27  4:43   ` William Crandall
      2012-05-27  7:35     ` Nicolas Goaziou
      2012-05-27 12:37     ` Jambunathan K
      0 siblings, 2 replies; 7+ messages in thread
    From: William Crandall @ 2012-05-27  4:43 UTC (permalink / raw)
      To: Bastien; +Cc: emacs-orgmode
    
    [-- Attachment #1: Type: text/plain, Size: 4880 bytes --]
    
    Hello Bastien,
    
    Thanks for your pointer to org-export!
    
    I got it running and see it is an improvement.
    
    Reading the archives, I've gathered some notions.
    (Please correct me if I'm wrong!)
    
    Is it true that:
    
    1. The org-export Package is a "Generic Export Engine"
       and is intended to support a new generation of
       org export tools (to HTML, LaTeX, ODT, etc).
    
    2. It is now an "experimental" Contributed Package:
       http://orgmode.org/worg/org-contrib
    
    3. The current (old) export command (C-c C-e) executes
       a function called "org-export" in org-exp.el (line 943)
       but it is not related to the new org-export package.
    
    4. API documentation for the new org-export, and it's family
       (org-e-ascii.el, org-e-html.el, org-e-latex.el, org-e-odt.el
       org-e-publish.el org-element.el), is here:
       http://orgmode.org/worg/org-api/
    
    5. Documentation for back-end developers working on new
       export tools is here:
       http://orgmode.org/worg/dev/org-export-reference.html
    
    6. Current org tutorials describe the old tool set, e.g.,
       "Publishing Org-mode files to HTML", not the new:
       http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.html
    
    7. No end-user documentation for the org-export package
       has been created, describing for example, how to link
       to an external CSS file (as #+STYLE used to work).
    
    8. "The Manual" does not (yet) document the org-export package:
       http://orgmode.org/manual/index.html
    
    9. This mailing list is the best place to ask questions.
    
    ------------------------------------------------------------
    
    
    Even if it's not a full BNF, and "only" 98% as Nicolas says,
    a quasi-complete grammar is a really good place to start, or
    re-start, building a "spaghetti-free" export system, IMO.
    
    
    ------------------------------------------------------------
    ------------------------------------------------------------
    
    
    Turning to my immediate challenge, exporting to html,
    I have some questions ( M-x org-export-dispatch h ):
    
    
    1. UTF-8
    
    How can I change the encoding, which defaults to:
    
       <?xml version="1.0" encoding="iso-8859-1"?>
    
    I set org-export-coding-system:
    
       (setq org-export-coding-system 'utf-8)
    
    And now:
    
       org-export-coding-system is a variable defined in `org-export.el'.
       Its value is utf-8
       Original value was nil
    
    But the exported html file still shows iso-8859-1
    
    
    --------------------------------------------------
    
    2. CSS
    
    I used to link to an external style file thus:
    
       #+STYLE: <link rel="stylesheet" type="text/css" href="css/about.css" />
    
    What syntax works now?
    
    
    --------------------------------------------------
    
    3. Configuring paths to images
    
       #+ATTR_HTML: alt="BC Crandall"
       [[/sites/a.png]]
    
    Exports to:
    
       <img src="g:/sites/a.png" alt="BC Crandall"/></p>
    
    One win; one fail.
    
    #+ATTR_HTML: works fine!
    
    But I'd like the path to be  <img src="/sites/a.png" ..
    without  "g:"
    
    
    --------------------------------------------------
    
    4. Paths to files
    
       [[/sites/my-file][My link]]
    
    Exports to:
    
       <a href="file://g:/sites/my-file">My link</a>
    
    How can I keep the path "as it was", and get this:
    
       <a href="/sites/my-file">My link</a>
    
    without "file://g:"
    
    
    --------------------------------------------------
    
    5. Removing Pre- and Postamble
    
    What now works like:
    
       (setq org-export-html-preamble nil)
       (setq org-export-html-postamble nil)
    
    Now, there is no preamble.
    
    The postamble is:
    
       <div id="postamble">
       <p class="date"> Date: 2012-05-26 20:59:51 Pacific Daylight Time </p>
       <p class="author"> Author : William BC Crandall</p>
       <p class="creator"> Generated by Org mode 7.8.11 in Emacs 24.1.50.1. </p>
          <a href="http://validator.w3.org/check?uri=referer">Validate XHTML
    1.0</a>
       </div>
    
    I'd like to remove both.
    
    
    --------------------------------------------------
    
    
    6. Special strings
    
    I was able to get a TM (&trade) in the old system with:
    
    (eval-after-load "org"
      '(setq org-export-html-special-string-regexps
         (append org-export-html-special-string-regexps
             '(("-TM-" . "&trade;")))))
    
    How now?
    
    
    --------------------------------------------------
    
    Thanks for any pointers or suggestions!
    
    And thanks to everyone working on this.
    
    -BC
    
    Org-mode: 7.8.11
    Emacs: 24.1.50.1
    Windows 7
    
    
    
    
    On Thu, May 24, 2012 at 2:01 AM, Bastien <bzg@gnu.org> wrote:
    
    > Hi William,
    >
    > William Crandall <bc3141592@gmail.com> writes:
    >
    > > Drupal inline image syntax is:
    > >
    > >   <img src="/sites/default/files/images/BC.png" alt="BC">
    > >
    > > Default Org-mode html-export, for  [[/sites/a.png]]  seems to be:
    > >
    > >   <img src="file://g:/sites/a.png"  alt="file://g:/sites/a.png" />
    >
    > Nicolas export engine does it right :
    >
    >  <img src="/sites/a.png"  alt="a.png"/>
    >
    > To use it, please pull from the git master repository then
    >
    > - add the "contrib/" directory to your load-path
    > - (require 'org-export)
    > - M-x org-export-dispatch h
    >
    > HTH,
    >
    > --
    >  Bastien
    >
    
    [-- Attachment #2: Type: text/html, Size: 19779 bytes --]
    
    ^ permalink raw reply	[flat|nested] 7+ messages in thread

  • • * Re: Drupal syntax on html-export for image links
        2012-05-27  4:43   ` William Crandall
      @ 2012-05-27  7:35     ` Nicolas Goaziou
        2012-05-27 12:41       ` Jambunathan K
        2012-05-27 12:37     ` Jambunathan K
        1 sibling, 1 reply; 7+ messages in thread
      From: Nicolas Goaziou @ 2012-05-27  7:35 UTC (permalink / raw)
        To: William Crandall; +Cc: Bastien, emacs-orgmode
      
      Hello,
      
      William Crandall <bc3141592@gmail.com> writes:
      
      > Is it true that:
      >
      > 1. The org-export Package is a "Generic Export Engine"
      >    and is intended to support a new generation of
      >    org export tools (to HTML, LaTeX, ODT, etc).
      
      Correct.
      
      > 2. It is now an "experimental" Contributed Package:
      >    http://orgmode.org/worg/org-contrib
      
      Correct.
      
      > 3. The current (old) export command (C-c C-e) executes
      >    a function called "org-export" in org-exp.el (line 943)
      >    but it is not related to the new org-export package.
      
      Correct.
      
      > 4. API documentation for the new org-export, and it's family
      >    (org-e-ascii.el, org-e-html.el, org-e-latex.el, org-e-odt.el
      >    org-e-publish.el org-element.el), is here:
      >    http://orgmode.org/worg/org-api/
      
      Correct, but be warned that some functions in org-exp.el use org-export-*
      prefix and might be found under "org-export" section.
      
      > 5. Documentation for back-end developers working on new
      >    export tools is here:
      >    http://orgmode.org/worg/dev/org-export-reference.html
      
      Correct.
      
      > 6. Current org tutorials describe the old tool set, e.g.,
      >    "Publishing Org-mode files to HTML", not the new:
      >    http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.html
      
      Correct.
      
      > 7. No end-user documentation for the org-export package
      >    has been created, describing for example, how to link
      >    to an external CSS file (as #+STYLE used to work).
      
      Correct.
      
      > 8. "The Manual" does not (yet) document the org-export package:
      >    http://orgmode.org/manual/index.html
      
      Correct.
      
      > 9. This mailing list is the best place to ask questions.
      
      Correct.
      
      
      
      > Turning to my immediate challenge, exporting to html,
      > I have some questions ( M-x org-export-dispatch h ):
      
      Since I don't maintain `e-html' back-end, I'll only answer partially.
      
      > 5. Removing Pre- and Postamble
      >
      > What now works like:
      >
      >    (setq org-export-html-preamble nil)
      >    (setq org-export-html-postamble nil)
      >
      > Now, there is no preamble.
      >
      > The postamble is:
      >
      >    <div id="postamble">
      >    <p class="date"> Date: 2012-05-26 20:59:51 Pacific Daylight Time </p>
      >    <p class="author"> Author : William BC Crandall</p>
      >    <p class="creator"> Generated by Org mode 7.8.11 in Emacs 24.1.50.1. </p>
      >       <a href="http://validator.w3.org/check?uri=referer">Validate XHTML
      > 1.0</a>
      >    </div>
      >
      > I'd like to remove both.
      
      You may have a look at `org-e-html-preamble' and `org-e-html-postamble'
      variables.
      
      > --------------------------------------------------
      >
      >
      > 6. Special strings
      >
      > I was able to get a TM (&trade) in the old system with:
      >
      > (eval-after-load "org"
      >   '(setq org-export-html-special-string-regexps
      >      (append org-export-html-special-string-regexps
      >          '(("-TM-" . "&trade;")))))
      >
      > How now?
      
      You can add a filter to plain text objects, which will only be applied
      to `e-html' back-end:
      
      #+begin_src emacs-lisp
      (defun my-html-trademark-markup (text backend info)
        (if (not (eq back-end 'e-html)) text
          (replace-regexp-in-string "-TM-" "&trade;" text)))
      
      (add-to-list 'org-export-filter-plain-text-functions
                   'my-html-trademark-markup)
      #+end_src
      
      Though, I would suggest to use entity \trade instead.
      
      
      Regards,
      
      -- 
      Nicolas Goaziou
      
      ^ permalink raw reply	[flat|nested] 7+ messages in thread

    • • * Re: Drupal syntax on html-export for image links
          2012-05-27  7:35     ` Nicolas Goaziou
        @ 2012-05-27 12:41       ` Jambunathan K
          0 siblings, 0 replies; 7+ messages in thread
        From: Jambunathan K @ 2012-05-27 12:41 UTC (permalink / raw)
          To: Nicolas Goaziou; +Cc: Bastien, emacs-orgmode, William Crandall
        
        > Since I don't maintain `e-html' back-end, I'll only answer partially.
        
        I don't want to take over the maintainership of org-e-html.  
        
        What I am saying is that, anyone with commit access to Orgmode - this
        includes me - can fix or patch up org-e-html without it being routed via
        me.
        
        +1 to Bastien for recommending the use of org-e-html.
        -- 
        
        ^ permalink raw reply	[flat|nested] 7+ messages in thread

    • * Re: Drupal syntax on html-export for image links
        2012-05-27  4:43   ` William Crandall
        2012-05-27  7:35     ` Nicolas Goaziou
      @ 2012-05-27 12:37     ` Jambunathan K
        2012-05-27 16:00       ` William Crandall
        1 sibling, 1 reply; 7+ messages in thread
      From: Jambunathan K @ 2012-05-27 12:37 UTC (permalink / raw)
        To: William Crandall; +Cc: Bastien, emacs-orgmode
      
      
      The exporter is new.  Needless to say there are bugs, known and
      unknown. (Think, "Rome wasn't built in a day")
      
      I have fixed few things.  I will respond later for unresolved other
      things in your list.
      
      > 7. No end-user documentation for the org-export package
      >    has been created, describing for example, how to link
      >    to an external CSS file (as #+STYLE used to work).
      
      This is fixed now.  
      
      > 8. "The Manual" does not (yet) document the org-export package:
      >    http://orgmode.org/manual/index.html
      
      The new exporter should behave exactly the same way as the old one.
      Otherwise, it is a bug.
      
      For all practical purposes, 
        M-x customize-group RET org-export-e-html RET 
      should suffice.
      
      Note that the defcustoms have `org-e-html-' as prefix. (Note the "e" in
      "e-html")
      
      > 1. UTF-8
      >
      > How can I change the encoding, which defaults to:
      
      Use `org-e-html-coding-system'.
      
      > --------------------------------------------------
      >
      > 2. CSS
      >
      > I used to link to an external style file thus:
      >
      >    #+STYLE: <link rel="stylesheet" type="text/css" href="css/
      > about.css" />
      >
      > What syntax works now?
      
      This is fixed.
      
      > 5. Removing Pre- and Postamble
      >
      > What now works like:
      >
      >    (setq org-export-html-preamble nil)
      >    (setq org-export-html-postamble nil)
      >
      > Now, there is no preamble.
      >
      > The postamble is:
      >
      >    <div id="postamble">
      >    <p class="date"> Date: 2012-05-26 20:59:51 Pacific Daylight Time
      > </p>
      >    <p class="author"> Author : William BC Crandall</p>
      >    <p class="creator"> Generated by Org mode 7.8.11 in Emacs
      > 24.1.50.1. </p>
      >       <a href="http://validator.w3.org/check?uri=referer">Validate
      > XHTML 1.0</a>
      >    </div>
      >
      > I'd like to remove both.
      
      Use `org-e-html-preamble' and `org-e-html-postamble'.
      
      
      > --------------------------------------------------
      >
      >
      > 6. Special strings
      >
      > I was able to get a TM (&trade) in the old system with:
      >
      > (eval-after-load "org"
      >   '(setq org-export-html-special-string-regexps
      >      (append org-export-html-special-string-regexps
      >          '(("-TM-" . "&trade;")))))
      >
      > How now?
      
      Nicolas has responded to this question.
      
      FYI, `org-export-html-special-string-regexps' becomes
      `org-e-html-special-string-regexps'.
      
      
      
      > 3. Configuring paths to images
      >
      >    #+ATTR_HTML: alt="BC Crandall"
      >    [[/sites/a.png]]
      >
      > Exports to:
      >
      >    <img src="g:/sites/a.png" alt="BC Crandall"/></p>
      >
      > One win; one fail.
      >
      > #+ATTR_HTML: works fine!
      >
      > But I'd like the path to be  <img src="/sites/a.png" ..
      > without  "g:"
      >
      >
      > --------------------------------------------------
      >
      > 4. Paths to files
      >
      >    [[/sites/my-file][My link]]
      >
      > Exports to:
      >
      >    <a href="file://g:/sites/my-file">My link</a>
      >
      > How can I keep the path "as it was", and get this:
      >
      >    <a href="/sites/my-file">My link</a>
      >
      > without "file://g:"
      >
      >
      > --------------------------------------------------
      >
      
      I will respond to 3 and 4 separately.  I need to look at this area
      closely. (I know nothing about HTML or HTML exporter.)
      
      What is "g:/" here.  Is it the publishing directory or the current
      directory.  Given that, does removing the leading "g:/" a specific
      requirement of yours or is it generally useful to anyone.
      
      ^ permalink raw reply	[flat|nested] 7+ messages in thread

    • • * Re: Drupal syntax on html-export for image links
          2012-05-27 12:37     ` Jambunathan K
        @ 2012-05-27 16:00       ` William Crandall
          0 siblings, 0 replies; 7+ messages in thread
        From: William Crandall @ 2012-05-27 16:00 UTC (permalink / raw)
          To: Jambunathan K; +Cc: Bastien, emacs-orgmode
        
        [-- Attachment #1: Type: text/plain, Size: 2475 bytes --]
        
        Hello Nicolas and Jambunathan,
        
        Many thanks, to you both, for such quick and detailed responses!
        
        I look forward to checking things out later today.
        
        And yes, +1 to Bastien for recommending!
        
        
        Regarding your notes on image and file paths:
        
        JK> I will respond to 3 and 4 separately.  I need to look at
        JK> this area closely. (I know nothing about HTML or HTML exporter.)
        
        JK> What is "g:/" here.  Is it the publishing directory or
        JK> the current directory.  Given that, does removing the leading
        JK> "g:/" a specific requirement of yours or is it generally useful
        JK> to anyone.
        
        The "g:/" is a Windows artifact, indicating the  drive. On Unix
        systems, root "/" is unique; on Windows there can be many drives
        indicated by letters at the root (c:/, d:/, .. z:/). The most common
        default for first hard disk is "c:/", but other letters are often used.
        http://en.wikipedia.org/wiki/Drive_letter_assignment
        
        I think that it would be generally useful to be able to remove
        the drive letter, so that c:/ or g:/ is transposed into just /
        so that when the link-string is passed to a publishing system,
        such as Drupal, it can easily digest it for further processing.
        
        Thanks again for all your work on this!
        
        -BC
        
        
        On Sun, May 27, 2012 at 5:37 AM, Jambunathan K <kjambunathan@gmail.com>wrote:
        
        >
        > The exporter is new.  Needless to say there are bugs, known and
        > unknown. (Think, "Rome wasn't built in a day")
        >
        
        [. . .]
        
        
        > > 3. Configuring paths to images
        > >
        > >    #+ATTR_HTML: alt="BC Crandall"
        > >    [[/sites/a.png]]
        > >
        > > Exports to:
        > >
        > >    <img src="g:/sites/a.png" alt="BC Crandall"/></p>
        > >
        > > One win; one fail.
        > >
        > > #+ATTR_HTML: works fine!
        > >
        > > But I'd like the path to be  <img src="/sites/a.png" ..
        > > without  "g:"
        > >
        > >
        > > --------------------------------------------------
        > >
        > > 4. Paths to files
        > >
        > >    [[/sites/my-file][My link]]
        > >
        > > Exports to:
        > >
        > >    <a href="file://g:/sites/my-file">My link</a>
        > >
        > > How can I keep the path "as it was", and get this:
        > >
        > >    <a href="/sites/my-file">My link</a>
        > >
        > > without "file://g:"
        > >
        > >
        > > --------------------------------------------------
        > >
        >
        > I will respond to 3 and 4 separately.  I need to look at this area
        > closely. (I know nothing about HTML or HTML exporter.)
        >
        > What is "g:/" here.  Is it the publishing directory or the current
        > directory.  Given that, does removing the leading "g:/" a specific
        > requirement of yours or is it generally useful to anyone.
        >
        
        [-- Attachment #2: Type: text/html, Size: 6491 bytes --]
        
        ^ permalink raw reply	[flat|nested] 7+ messages in thread

end of thread, other threads:[~2012-05-27 16:00 UTC | newest]

Thread overview: 7+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2012-05-24  4:55 Drupal syntax on html-export for image links William Crandall
2012-05-24  9:01 ` Bastien
2012-05-27  4:43   ` William Crandall
2012-05-27  7:35     ` Nicolas Goaziou
2012-05-27 12:41       ` Jambunathan K
2012-05-27 12:37     ` Jambunathan K
2012-05-27 16:00       ` William Crandall

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).