Konversation/Konvi2x: Difference between revisions

    From KDE UserBase Wiki
    No edit summary
    Line 29: Line 29:


    Under the hood
    Under the hood
    * UI being rewritten in Qt Quick & Kirigami
    * Model/view architecture allows dynamic filtering of chat contents (i.e.  
    * Model/view architecture allows dynamic filtering of chat contents (i.e.  
       retroactive show/hide of joins and parts) or combined views
       retroactive show/hide of joins and parts) or combined views

    Revision as of 03:06, 21 September 2017

    Preface

    This page aims to get you started with the WIP branch that will one day become Konversation 2.x.

    Work log

    Wondering what's new already? What follows is a (sporadically updated!) list of some of the new features and abilities compared to the stable Konversation 1.7.x version:

    Interface layout
    * Responsive/collapsible two-column design enables useful small/mini window mode
    
    Text view
    * Hanging indent / all messages start at the same column
    * Groups consecutive messages by the same author
    * Does not repeat timestamp when unnecessary
    * Can update colors dynamically for backlog
    
    Tab completion
    * Most-recently-active-nick-first now works in popup mode
    * Popup mode has much better ergonomics than before
    * Completion now ignores special characters in nicknames
    * Basic command completion
    * Completion now works in private conversations (all nicks on the server)
    
    Input field
    * You can now have a shared input field (with shared history) between all tabs
    * History system now restores cursor position when arrow'ing back down to last 
      edited text
    
    Under the hood
    * UI being rewritten in Qt Quick & Kirigami
    * Model/view architecture allows dynamic filtering of chat contents (i.e. 
      retroactive show/hide of joins and parts) or combined views
    * Lower memory usage due to less redundant document data and not keeping 
      unnecessary text views around

    Also check out this blog post for our goals!

    Sources

    Work is being carried out on the wip/qtquick branch of the konversation.git repository.

    Check out the general build instructions first.

    Build dependencies

    The WIP branch has higher version demands for some dependencies as well as new dependencies. Specifically:

    • Qt 5.9.x
    • Master branch of KF5::Kirigami (kirigami.git)
    • Master branch of qqc2-desktop-style (qqc2-desktop-style.git)

    Getting the branch

    In contrast to the general build instructions, either clone this way:

    git clone git://anongit.kde.org/konversation --branch wip/qtquick
    

    ... or run these commands in an existing git clone dir:

    git fetch origin
    git checkout wip/qtquick
    

    Flatpak

    NOTE: We're still working on tuning the Flatpak generation. If it's broken, try again the next day - sorry!

    We also have a Flatpak nightly package.

    Check out the KDE Flatpak HOWTO first.

    To install, run:

    flatpak remote-add kderuntime --from http://distribute.kde.org/kderuntime.flatpakrepo
    flatpak remote-add kdeapps --from https://distribute.kde.org/kdeapps.flatpakrepo
    flatpak install kdeapps org.kde.konversation-konvi2x
    

    This will add a "(Nightly) (Konvi2x) Konversation" entry into your desktop menu.

    Running the branch (imporant - read here!)

    At any time, you can use the F10 key to switch between the old and new Konversation UIs.

    The following command line examples expand on each other. To show the new Qt Quick-based UI immediately at start, run Konversation like this:

    konversation --qtquick
    

    Konversation is usually only allowed to run once. To bypass this restriction and run a second instance of Konversation, run Konversation like this:

    konversation --qtquick --nui
    

    To avoid auto-connecting to your networks with a test build, run Konversation like this:

    konversation --qtquick --nui --noautoconnect
    

    This last example is good set of arguments for hacking and testing. Additionally, you can override the UI package with --uipackage <package name>.

    Update: The branch now installs a konvi2x executable that's equivalent to konversation --qtquick --nui.

    Links