• Share
  • Email
  • Embed
  • Like
  • Save
  • Private Content
ReST Editor - Eclipse Demo Camp Grenoble 2011
 

ReST Editor - Eclipse Demo Camp Grenoble 2011

on

  • 5,163 views

Presentation of the ReST Edito

Presentation of the ReST Edito

Statistics

Views

Total Views
5,163
Views on SlideShare
4,886
Embed Views
277

Actions

Likes
0
Downloads
21
Comments
0

2 Embeds 277

http://www.coderxpress.net 275
http://www.slideshare.net 2

Accessibility

Categories

Upload Details

Uploaded via as Adobe PDF

Usage Rights

© All Rights Reserved

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Processing…
Post Comment
Edit your comment

    ReST Editor - Eclipse Demo Camp Grenoble 2011 ReST Editor - Eclipse Demo Camp Grenoble 2011 Presentation Transcript

    • reStructuredText ReST Editor Questions ? ReST Editor Thomas Calmant isandlaTechThomas Calmant isandlaTech ReST Editor
    • Outline 1 reStructuredText A documentation language Sample code How to provide documents ? Compilation process Known users Existing editors 2 ReST Editor reStructuredText edition in Eclipse Open source plug-in The Run configuration A word about wrapping
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsA documentation language Designed for Python documentation (code and references) Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsA documentation language Designed for Python documentation (code and references) Defined at docutils.sourceforge.net by David Goodger Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsA documentation language Designed for Python documentation (code and references) Defined at docutils.sourceforge.net by David Goodger Plain text mark-up language Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsA documentation language Designed for Python documentation (code and references) Defined at docutils.sourceforge.net by David Goodger Plain text mark-up language Easy to read / write without specific tools Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsA documentation language Designed for Python documentation (code and references) Defined at docutils.sourceforge.net by David Goodger Plain text mark-up language Easy to read / write without specific tools Compilable into many output formats (HTML, LaTex, CHM, man, QtDoc, ...) Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsSample code How to provide documents ? ========================== With |rest| : .. image:: _static/workflow-rst.png :align: center :height: 3cm * One source format * Can be an aggregation of multiple .rst files * Plain text, so complete version control can be done with Git, Subversion, ... Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsHow to provide documents ? The old way : Time wasting Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsHow to provide documents ? The old way : Time wasting Possible update errors Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsHow to provide documents ? The old way : Time wasting Possible update errors May need to have the document in different source formats Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsHow to provide documents ? The old way : Time wasting Possible update errors May need to have the document in different source formats Nearly impossible to have a correct version control Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsHow to provide documents ? With reStructuredText : One source format Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsHow to provide documents ? With reStructuredText : One source format Can be an aggregation of multiple .rst files Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsHow to provide documents ? With reStructuredText : One source format Can be an aggregation of multiple .rst files Plain text, so complete version control can be done with Git, Subversion, ... Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsHow to provide documents ? With reStructuredText : One source format Can be an aggregation of multiple .rst files Plain text, so complete version control can be done with Git, Subversion, ... Compiled with the same tool for major outputs : Sphinx Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsCompilation process Sphinx : generates major outputs (HTML, LaTex, man, QtDoc, ...) Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsCompilation process Sphinx : generates major outputs (HTML, LaTex, man, QtDoc, ...) Some other tools exist : Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsCompilation process Sphinx : generates major outputs (HTML, LaTex, man, QtDoc, ...) Some other tools exist : rst2pdf : generates PDF without LaTex (uses ReportLab library) Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsCompilation process Sphinx : generates major outputs (HTML, LaTex, man, QtDoc, ...) Some other tools exist : rst2pdf : generates PDF without LaTex (uses ReportLab library) rst2beamer : generates a LaTex Beamer presentation Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsCompilation process Sphinx : generates major outputs (HTML, LaTex, man, QtDoc, ...) Some other tools exist : rst2pdf : generates PDF without LaTex (uses ReportLab library) rst2beamer : generates a LaTex Beamer presentation rst2odt : generates Open/LibreOffice documents Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsCompilation process Sphinx : generates major outputs (HTML, LaTex, man, QtDoc, ...) Some other tools exist : rst2pdf : generates PDF without LaTex (uses ReportLab library) rst2beamer : generates a LaTex Beamer presentation rst2odt : generates Open/LibreOffice documents rst2a : an on-line styled PDF generator Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsCompilation process Sphinx : generates major outputs (HTML, LaTex, man, QtDoc, ...) Some other tools exist : rst2pdf : generates PDF without LaTex (uses ReportLab library) rst2beamer : generates a LaTex Beamer presentation rst2odt : generates Open/LibreOffice documents rst2a : an on-line styled PDF generator All are based on Python, using the official docutils parser. Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsKnown users Guides & References Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsKnown users Guides & References Python Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsKnown users Guides & References Python Bazaar Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsKnown users Guides & References Python Bazaar Blender Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsKnown users Guides & References Python Bazaar Blender OpenERP Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsKnown users Guides & References Python Bazaar Blender OpenERP Zope Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsKnown users Guides & References Python Bazaar Blender OpenERP Zope Many others Python and non-Python projects Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsKnown users Guides & References Python Bazaar Blender OpenERP Zope Many others Python and non-Python projects Books Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsKnown users Guides & References Python Bazaar Blender OpenERP Zope Many others Python and non-Python projects Books C/C++ Software Development with Eclipse (on-line book) Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsKnown users Guides & References Python Bazaar Blender OpenERP Zope Many others Python and non-Python projects Books C/C++ Software Development with Eclipse (on-line book) The repoze.bfg Web Application Framework (printed book) Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsExisting editors Few editors with a real support (vim, emacs, JED, ...) Thomas Calmant isandlaTech ReST Editor
    • A documentation language Sample code reStructuredText How to provide documents ? ReST Editor Compilation process Questions ? Known users Existing editorsExisting editors Few editors with a real support (vim, emacs, JED, ...) Often with only a syntax coloration support Thomas Calmant isandlaTech ReST Editor
    • Outline 1 reStructuredText A documentation language Sample code How to provide documents ? Compilation process Known users Existing editors 2 ReST Editor reStructuredText edition in Eclipse Open source plug-in The Run configuration A word about wrapping
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingreStructuredText edition in Eclipse Syntax coloration Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingreStructuredText edition in Eclipse Syntax coloration Document hierarchy edition using the Outline view Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingreStructuredText edition in Eclipse Syntax coloration Document hierarchy edition using the Outline view Directives help on mouse hover Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingreStructuredText edition in Eclipse Syntax coloration Document hierarchy edition using the Outline view Directives help on mouse hover Basic context assistance Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingreStructuredText edition in Eclipse Syntax coloration Document hierarchy edition using the Outline view Directives help on mouse hover Basic context assistance A Sphinx/Makefile run configuration Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingreStructuredText edition in Eclipse Syntax coloration Document hierarchy edition using the Outline view Directives help on mouse hover Basic context assistance A Sphinx/Makefile run configuration Spell checking with Hunspell4Eclipse Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingOpen source plug-in Open source plug-in, hosted at SourceForge.net. Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingOpen source plug-in Open source plug-in, hosted at SourceForge.net. Project site : resteditor.sourceforge.net Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingOpen source plug-in Open source plug-in, hosted at SourceForge.net. Project site : resteditor.sourceforge.net Update site : resteditor.sourceforge.net/eclipse Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingOpen source plug-in Open source plug-in, hosted at SourceForge.net. Project site : resteditor.sourceforge.net Update site : resteditor.sourceforge.net/eclipse Available on the Marketplace Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingOpen source plug-in Open source plug-in, hosted at SourceForge.net. Project site : resteditor.sourceforge.net Update site : resteditor.sourceforge.net/eclipse Available on the Marketplace Contributors are welcome ! Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingThe Run configuration Needs Python and Sphinx to be installed on the system Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingThe Run configuration Needs Python and Sphinx to be installed on the system Works on Unix-like (Makefile) and Windows (make.bat) Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingThe Run configuration Needs Python and Sphinx to be installed on the system Works on Unix-like (Makefile) and Windows (make.bat) Allows to run any Makefile Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingThe Run configuration Needs Python and Sphinx to be installed on the system Works on Unix-like (Makefile) and Windows (make.bat) Allows to run any Makefile Allows to provide an environment to the command Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingA word about wrapping No line wrapping support in built-in TextEditor Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingA word about wrapping No line wrapping support in built-in TextEditor ReST Editor hard line wrapping inspired from Texlipse method Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingA word about wrapping No line wrapping support in built-in TextEditor ReST Editor hard line wrapping inspired from Texlipse method Modifies the document with an auto-edit strategy Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingA word about wrapping No line wrapping support in built-in TextEditor ReST Editor hard line wrapping inspired from Texlipse method Modifies the document with an auto-edit strategy Detects blocks of similar lines, then wrap and replace the whole block Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingA word about wrapping No line wrapping support in built-in TextEditor ReST Editor hard line wrapping inspired from Texlipse method Modifies the document with an auto-edit strategy Detects blocks of similar lines, then wrap and replace the whole block Soft line wrapping support : Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingA word about wrapping No line wrapping support in built-in TextEditor ReST Editor hard line wrapping inspired from Texlipse method Modifies the document with an auto-edit strategy Detects blocks of similar lines, then wrap and replace the whole block Soft line wrapping support : Uses the hard line wrapping, but storing information about wrapped blocks Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingA word about wrapping No line wrapping support in built-in TextEditor ReST Editor hard line wrapping inspired from Texlipse method Modifies the document with an auto-edit strategy Detects blocks of similar lines, then wrap and replace the whole block Soft line wrapping support : Uses the hard line wrapping, but storing information about wrapped blocks Un-wraps blocks on save Thomas Calmant isandlaTech ReST Editor
    • reStructuredText edition in Eclipse reStructuredText Open source plug-in ReST Editor The Run configuration Questions ? A word about wrappingA word about wrapping No line wrapping support in built-in TextEditor ReST Editor hard line wrapping inspired from Texlipse method Modifies the document with an auto-edit strategy Detects blocks of similar lines, then wrap and replace the whole block Soft line wrapping support : Uses the hard line wrapping, but storing information about wrapped blocks Un-wraps blocks on save Problem : implied modifications on save always set the document state to dirty Thomas Calmant isandlaTech ReST Editor
    • reStructuredText ReST Editor Questions ?Questions ? Any question ? Thomas Calmant isandlaTech ReST Editor