[CODE4LIB] Job: Bellevue, WA: Sr Electronic Records Analyst, Puget Sound Energy at Puget Sound Energy
Senior Electronic Records Analyst #14464 Location : Bellevue Job # : 14464 At Puget Sound Energy (PSE) we have a long tradition of service, and an exciting and innovative future ahead! Consider PSE for the next step in your career. Job Summary Responsibilities Puget Sound Energy's Drafting and Records department is looking for a Senior Electronic Records Analyst to join our team! This position provides Open Text Content Server support to the end user community. You will be expected to interact with all levels of PSE employees to define electronic records needs and translate them into a value added solution. Incumbents in this job perform requirements analysis activities and assume a hands-on technical lead role with project teams. The position will play a significant role in managing the Open Text ECM system. Primary responsibilities include; managing electronic and physical records, managing user access and content administration, plan and perform migration of existing records collections, provide end user training. This is an excellent opportunity to play an integral role within PSE to help us better serve the environment, our customers and the communities in which they live. PSE provides an environment where all employees are valued, respected and provided with the opportunity to achieve maximum performance. We offer a comprehensive pay package that includes competitive compensation, annual goals-based incentive bonuses, comprehensive cafeteria-style benefits, 401(K), a company paid retirement pension plan and an employee assistance and wellness program. Gain the energy to do great things through a career with Puget Sound Energy! This position is posted under job ID 14464 on the [PSE Career Page](http://www.pse.com/careers). Source: [ICRM](https://db.icrm.org/crm/index.jsp?submit_menu=166) Brought to you by code4lib jobs: http://jobs.code4lib.org/job/4196/
[CODE4LIB] Job: Discovery Services Librarian at University of Colorado at Denver
The Auraria Library seeks a creative, flexible, and innovative individual who is able to handle multiple priorities in a fast-paced environment, to work independently and collegially with internal and external campus constituents, and who will contribute to a customer service oriented library. Reporting to the Associate Director of Technical Services, this position will collaborate with a wide range of library units to support the discoverability of library resources in both the physical and digital realms. Specifically, the position will contribute to the continuous improvement, extension, and integration of the Library's various systems and search tools, including the library catalog, discovery layer, library website, ERM, knowledge base management, institutional repository and other digital delivery platforms. The Discovery Services Librarian is a member of the Auraria Library's tenure-track faculty. Significant parts of the responsibilities of this position are scholarly activity, creative work, and service in keeping with the tenure standards of the University of Colorado at Denver. Brought to you by code4lib jobs: http://jobs.code4lib.org/job/4203/
[CODE4LIB] Job: Server Specialist (Job Id 2907) at California State University, Northridge
California State University, Northridge (Northridge, CA) Major Duties Under general supervision, the Library Server Specialist oversees the Linux servers run by the Oviatt Library; administers, programs, troubleshoots and maintains virtual servers provided by campus Information Technology; installs applications and patches; develops Bash, Perl, PHP and SQL scripts to automate tasks and monitor system performance; monitors servers for potential security issues/intrusion attacks; provides programming and other support to Library Systems staff; works with central Information Technology staff in managing the Library's virtual servers hosted by central IT; works on special projects, and performs other duties as assigned. Qualifications Equivalent to graduation from an accredited four-year college or university in a related field. Two years of full-time, progressively responsible field- related experience that includes knowledge of Linux servers and software (including system modification, installation, evaluation, and system development). Experience with database design and programming, preferably MySQL. Knowledge, Skills and Abilities: Thorough knowledge of a variety of software application packages, equipment platforms, reference database systems and sources, and training methods; and a basic understanding of networks, data communication, and multimedia systems. Functional knowledge of: XHTML/CSS, PHP, XML, XSLT, JavaScript, or other programming and scripting language; familiarity with Windows Server, Internet Information Server, MS SQL Server, and Active Directory desirable. Ability and specialized skills to: apply and assess user needs; identify, analyze and address user problems; analyze problems and propose effective solutions; understand functional and procedural requirements, and develop alternative solutions; relate system solutions to departmental management and staff; communicate effectively, both orally and in writing; and establish and maintain cooperative working relationships with students, faculty, staff, and administration. Brought to you by code4lib jobs: http://jobs.code4lib.org/job/4211/
[CODE4LIB] Job: Coordinator of Discovery Services at University of North Carolina at Wilmington
The William Madison Randall Library at The University of North Carolina Wilmington (UNCW) invites applications for the Coordinator of Discovery Services position. UNCW is a member institution of the University of North Carolina, a multi-campus university composed of all 17 of North Carolina's public institutions. UNCW is nationally recognized for its marine sciences teaching and research programs, and for its strengths in arts and sciences, business, education, and nursing. The University is situated on a beautiful arboretum campus located in an historic port city within five miles of the Atlantic Ocean and currently enrolls approximately 13,000 students. DUTIES AND RESPONSIBILITIES: The person in this position works in the Information Technology and Systems Division and coordinates the planning, management, development, implementation and continuous assessment of Randall Library's web presence, ensuring that services provided meet users' information and research needs and expectations, enhance the user experience, and support the Library's strategic plan. _Web Services:_ The Library's web/online presence provides the University with primary information discovery and access tools, which are becoming increasingly sophisticated. This position provides a wide range of expertise, guidance, and management of a variety of services and activities in this online arena, including but not limited to the following - - * Development and maintenance of web services such as the Library's multi-faceted web site, online catalog, discovery layer, application development, and mobile and other device support; * Assessment of user experience to ensure efficient and effective content discovery and access; * Integration and maintenance of related library systems such as electronic reserves, interlibrary loan, electronic resource management, acquisitions, cataloging, campus portals; * Evaluation of emerging technologies to provide the most appropriate discovery and access mechanisms; * Support of internal communication and collaboration tools for an effective work environment for the Library faculty and staff of 50; * Planning and management of projects that require the input, expertise, and efforts of supervised and non-supervised colleagues. Brought to you by code4lib jobs: http://jobs.code4lib.org/job/4216/
[CODE4LIB] Job: Integrated Library System Administrator at Clackamas County
The Library Information Network is a division of the County's Department of Business and Community Services. The Library Information Network of Clackamas County provides programs and services to 11 independent public libraries. Services include OCLC cataloging, an Inter-library Loan Program, computer system/WAN administration, and inter-library courier delivery services. RESPONSIBILITIES Duties may include but are not limited to the following: 1. Administers and maintains the operation of a complex relational database and integrated library software (ILS) systems, applications, and other databases; diagnoses and resolves software problems, communicates and collects information from clients on problems, and determines possible solutions and implements solutions given client input; prepares written proposals or reports on solution process; documents developed programs; writes operating procedures and updates user manuals. 2. Prepares and develops logical operational sequences to be performed by Library Network, ILS and other programs or applications; uses tools, appropriate computer programming languages to access information, develop reports and programming, and solve software problems or requests; tests and debugs programs to assure operational accuracy and stability; plans, tests and coordinates upgrades; researches and investigates new information relative to ILS; and coordinates ILS migration as needed. 3. Provides training, technical support and guidance to clients individually, and/or in groups and committees and also Library Network staff in the areas of library application software and standard library operating procedures and policies; works with clients to develop policies and procedures that ensure the ILS is implemented in adherence to best practices and library standards; oversees the preparation of instruction manuals for ILS and related systems; collaborates with library clients on special projects. 4. Serves as the primary technical contact with library automation software and licensed database vendors; works with staff, clients, and the ILS vendor to fulfill software development requests and refine the functionality of the ILS. 5. Develops and implements working software applications according to library needs; participates in the design, web-design, development, implementation, and maintenance of desktops and servers (e.g. Online Public Access Catalog); employs in-depth use of HTML/CSS web development; participates in the development of procedures and network resource acquisition; responsible for LINCC web content and client information updates. 6. Provides high level of customer service to the library clients and their patrons communicating with staff and clients about technology and software needs. 7. Investigates new technologies; works with clients, Manager, and Network staff on technology needs, goals, and plans; maintains and increases knowledge and skills through attendance at meetings, conferences, training seminars, and in-service training sessions. 8. Acts on behalf of the Library Network Manager in his/her absence or at his/her direction. QUALIFICATIONS Thorough knowledge of: core library science areas (acquisitions, cataloging, circulation, reference, interlibrary loan, and online searching); library/network programs and their relationship to community needs; automated library circulation and on-line catalog systems, including systems with web- interfaces and interlibrary loan tools and practices. Working knowledge of: Library computer systems, the library automation marketplace and recent developments in Library automation standards and practices; library telecommunications, networking, and shared systems; project planning and management, especially library system migrations to new hardware and software platforms; Machine-Readable Cataloging (MARC) format and how library systems load store and index data; familiarity with metadata and other library formats; of customer service concepts and techniques; HTML/CSS web development; Windows and Unix programs and operating systems; use of application programming interface (API) and Perl. Skill to: Analyze a wide variety of problems related to library/network services/software, recommend appropriate action and implement solutions; develop and maintain cooperative working relationships with network members, the public and library automation system vendors and to build consensus and to facilitate meetings; provide leadership in managing a group of diverse users to achieve consensus on complex system management issues; communicate effectively, both orally and in writing including communicating technical information to non-technical users; compile and analyze data and to design and present effective training to library staff on all aspects of the automation process; interpret needs and design/create appropriate working software solutions according to library needs; tactfully interact with and respond to staff
[CODE4LIB] Job: Digital Preservation Archivist at Lincoln Laboratory
MIT Lincoln Laboratory has pioneered in advanced electronics since its origin in 1951 as a Federally Funded Research and Development Center of the Massachusetts Institute of Technology. The Knowledge Services team is currently developing infrastructure for a digital preservation repository system. As such, we seek a Digital Preservation Archivist to join our team and direct strategic and project planning for our digital archives. Responsibilities: Under the direction of the Archivist and Knowledge Services Team Leadership, the Digital Preservation Archivist will: • Work closely with the Archives, Knowledge Services, IT staff, and other experts to research, define, and maintain an ongoing preservation program, based on best practices and established standards, for Laboratory collections of value in digital formats. • Work with Archives, Knowledge Services, IT staff, and other experts to research, test, specify, and implement technology for a sustainable digital preservation repository system which will meet the ongoing management, access, and preservation needs of the Laboratory. • Enhance digital preservation project plans, workflows, and policies for archiving of and long-term access to the Laboratory Archives digital collections. • Promote the Archives and digital preservation program through briefings, digital and social media. • Recommend, implement, and provide leadership for proposed digital preservation projects. • Provide training, support, and documentation for digital preservation projects. • Serve as an advisor for Knowledge Services, Information Services Department and our constituents on digital preservation; including maintaining current awareness of new technologies and initiatives in the field. • Appraisal, arrangement, description, and basic preservation for Laboratory historical records. • Support Archives operations and participate in other related work as assigned. Required Qualifications: • ALA-MLS/MLIS and a minimum three years' progressive experience working in an archival repository or library on digital resources projects in a leadership role. • Demonstrated knowledge and experience with open source digital repository systems and related technology including audit/fixity software, file forensics, media conversion, and editing metadata for digital objects, especially METS and PREMIS. • Proven experience with project management, outreach and marketing. • Ability to effectively convey and explain information clearly and tactfully. • Demonstrated ability to build consensus and promote the exchange of information among project team members, project management staff and elsewhere. • Demonstrated ability to work calmly and effectively in situations under pressure and to manage time effectively in a changing environment. • Must be able to obtain DoD Security Clearance. Desired Qualifications • Experience handling classified documentation. • Working knowledge of Java, PHP, SQL, and Web Services (e.g. SOAP, REST). Brought to you by code4lib jobs: http://jobs.code4lib.org/job/4223/
[CODE4LIB] Job: Digital Curator-Journalism/Mass Media at University of Missouri
The University of Missouri Libraries seeks a highly motivated professional to exercise leadership in strategically planning, developing, and implementing policies and practices relating to the management, preservation, and access to digital media and historical documents created by the journalism profession and allied organizations. Principal duties include formulating and executing a cohesive collection development plan for journalism records in all formats. Leads in the appraisal, inventory, acquisition and storage of journalism collections and works with Missouri School of Journalism staff and faculty to locate and solicit important primary source materials. Provides curatorial and archival guidance to programs of the Missouri School of Journalism and affiliated organizations. Assists the University Archivist in developing a business plan to create sustainable archival services for journalism associations and organizations. The position will be filled at the Librarian/Archivist-II level, with salary depending upon the qualifications of the chosen candidate. Refer to the MU Library Governance Document for further information: http://mu libraries.missouri.edu/staff/admin/hr/Gov_Doc/Governance%20Document_rev2012.pd f The appointment is renewable annually at the discretion of the University. Circumstances affecting continued employment include, but are not limited to, work performance, fund availability, and educational priorities. The position is dual-reporting to both the University Archivist and the Executive Director of the Reynolds Journalism Institute, with guidance from the Journalism Librarian, and with an office in the Missouri School of Journalism or the Reynolds Journalism Institute. Minimum Qualifications: * MLS from an ALA accredited program or a Masters Degree in a relevant field of study. * Course work in archives or records management with digital materials emphasis. * Thorough knowledge of archival and records management procedures and processes. * Strong customer service orientation and communication and problem solving skills. * Demonstrated ability to work independently under general supervision and work with people in a collegial, consultative, and collaborative environment. Preferred Qualifications: (preference will be given to candidates with the strongest combination of the following qualifications) * Knowledge of journalism history, photography, broadcasting or related disciplines. * Minimum of one year of experience in an academic library setting dealing with digital records. * Professional familiarity with current trends in archival preservation as it relates to media holdings and with issues surrounding the creation and management of digital objects in sound and visual formats. * Demonstrated interpersonal experience working in groups and across units. * Certification by the Academy of Certified Archivists or other certification program. Brought to you by code4lib jobs: http://jobs.code4lib.org/job/4245/
[CODE4LIB] Job: Discovery Services Librarian at University of Colorado at Boulder
The Auraria Library seeks a creative, flexible, and innovative individual who is able to handle multiple priorities in a fast-paced environment, to work independently and collegially with internal and external campus constituents, and who will contribute to a customer service oriented library. Reporting to the Associate Director of Technical Services, this position will collaborate with a wide range of library units to support the discoverability of library resources in both the physical and digital realms. Specifically, the position will contribute to the continuous improvement, extension, and integration of the Library's various systems and search tools, including the library catalog, discovery layer, library website, ERM, knowledge base management, institutional repository and other digital delivery platforms. Examples of duties performed: * Performs adaptive and original cataloging in all formats, such as print, physical non-print, electronic materials, digital and archival projects. * Participates in library teams, on-going activities, and special projects related to cataloging, digital projects, and bibliographic control. Keeps abreast of current and emerging trends, issues, and methods of electronic resources management and metadata standards. * Provides, monitors, and manages proper cataloging standards and procedures for all materials * Performs some supervisory responsibilities. * Serves on a variety of internal and external committees. * Participates in conferences and contributes to the profession through publications, presentations, etc. Required Education/Experience/Skills (Minimum Qualifications): * Master's in Library Information Science (ALA-accredited preferred) * Knowledge of resource description using national cataloging standards (AACR2, LCSH, LCC, and MARC). * Knowledge of RDA, FRBR, linked data, and symantic web. * Knowledge of authority control. * Knowledge of cataloging applications such as the cataloging module of an integrated library system, OCLC Connexion, and MarcEdit. * Knowledge of current and emerging trends, issues, and methods of access and discovery to scholarly resources. * Excellent planning, organizational and communication skills. * Ability to work well within a team environment with diverse groups of library faculty and staff. * Potential for research, scholarly work, and professional service. Brought to you by code4lib jobs: http://jobs.code4lib.org/job/4246/
Re: [CODE4LIB] EPUB and ILS indexing
This is an area where the code4lib community can have a huge impact. Conversely, if the Code4lib community doesn't have a big impact, we're in trouble. I urge everyone to have a look at the OS projects that SourceFabric is involved in. In particular, BookType is a django web app that lets people collaboratively produce EPUB ebooks. If you want to implement a community ebook publishing platform, this is what you want to hop onto. I'm really glad to see Henru-Damien looking at this, I think he could use help! Eric On Oct 29, 2012, at 1:11 PM, Henri-Damien LAURENT henridamien.laur...@free.fr wrote: Le 29/10/2012 14:55, Jodi Schneider a écrit : Sounds great! Have you thought about starting from OPDS? http://opds-spec.org/about/ Thanks for that hint Jodi. Nope, I hadnot tought about using OPDS. It looks really great. But from what I know of ILSes, ATOM feeds are not yet getting indexed straight into the catalog. But that could be something great. Might be worth talking to some EPUB folks -- for instance Peter Brantley, or else folks from threepress.org? I am already in contacts with some people from the EPUB world (namely SourceFabric, gluejar, and tea-ebook). But could be interesting to have more feedback. -Jodi On Mon, Oct 29, 2012 at 12:19 PM, Henri-Damien LAURENT henridamien.laur...@free.fr wrote: Hi, I am about to write a tool which would help indexing EPUB into ILSes. My first guess is to produce ISO2709 or MARCXML record from EPUB files, but since MARCXML or ISO2709 is not really what I would call the more portable (UNIMARC and MARC21 may both be handled in the same file format), I am rather considering producing OAI-DC or html5 +schema.org http://schema.org/+dublin corebut that would rely on EPUB3. Any comment anyone ? Has anyone considered such a tool ? Is there any hidden corpse lurking around I should be aware of ? Have a nice day -- Henri-Damien LAURENT -- Henri-Damien LAURENT
[CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
Hi all code4lib-bers, As coders and coding librarians, what is ONE tool and/or resource that you recommend to newbie coders in a library (and why)? I promise I will create and circulate the list and make it into a Code4Lib wiki page for collective wisdom. =) Thanks in advance! Bohyun --- Bohyun Kim, MA, MSLIS Digital Access Librarian bohyun@fiu.edu 305-348-1471 Medical Library, College of Medicine Florida International University http://medlib.fiu.edu http://medlib.fiu.edu/m (Mobile)
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
On 1 November 2012, Michael J. Giarlo wrote: Not to be glib, but: code4lib. +1 Bill -- William Denton Toronto, Canada http://www.miskatonic.org/
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
http://journal.code4lib.org On 11/1/2012 4:24 PM, Bohyun Kim wrote: Hi all code4lib-bers, As coders and coding librarians, what is ONE tool and/or resource that you recommend to newbie coders in a library (and why)? I promise I will create and circulate the list and make it into a Code4Lib wiki page for collective wisdom. =) Thanks in advance! Bohyun --- Bohyun Kim, MA, MSLIS Digital Access Librarian bohyun@fiu.edu 305-348-1471 Medical Library, College of Medicine Florida International University http://medlib.fiu.edu http://medlib.fiu.edu/m (Mobile)
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
StackExchange (by extension, StackOverflow and the Libraries StackExchange site). gliblessly, Mark A. Matienzo m...@matienzo.org Digital Archivist, Manuscripts and Archives, Yale University Library Technical Architect, ArchivesSpace On Thu, Nov 1, 2012 at 4:56 PM, Jonathan Rochkind rochk...@jhu.edu wrote: http://journal.code4lib.org On 11/1/2012 4:24 PM, Bohyun Kim wrote: Hi all code4lib-bers, As coders and coding librarians, what is ONE tool and/or resource that you recommend to newbie coders in a library (and why)? I promise I will create and circulate the list and make it into a Code4Lib wiki page for collective wisdom. =) Thanks in advance! Bohyun --- Bohyun Kim, MA, MSLIS Digital Access Librarian bohyun@fiu.edu 305-348-1471 Medical Library, College of Medicine Florida International University http://medlib.fiu.edu http://medlib.fiu.edu/m (Mobile)
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
Do you all really want a C4L wiki page that lists c4l and c4l journal on top of recommended resources? I bet you do, but let's try some diversity, shall we? ~Bohyun -Original Message- From: Code for Libraries [mailto:CODE4LIB@LISTSERV.ND.EDU] On Behalf Of Jonathan Rochkind Sent: Thursday, November 01, 2012 4:57 PM To: CODE4LIB@LISTSERV.ND.EDU Subject: Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library? http://journal.code4lib.org On 11/1/2012 4:24 PM, Bohyun Kim wrote: Hi all code4lib-bers, As coders and coding librarians, what is ONE tool and/or resource that you recommend to newbie coders in a library (and why)? I promise I will create and circulate the list and make it into a Code4Lib wiki page for collective wisdom. =) Thanks in advance! Bohyun --- Bohyun Kim, MA, MSLIS Digital Access Librarian bohyun@fiu.edu 305-348-1471 Medical Library, College of Medicine Florida International University http://medlib.fiu.edu http://medlib.fiu.edu/m (Mobile)
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
lynda.com On Thu, Nov 1, 2012 at 5:00 PM, Bohyun Kim k...@fiu.edu wrote: Do you all really want a C4L wiki page that lists c4l and c4l journal on top of recommended resources? I bet you do, but let's try some diversity, shall we? ~Bohyun -Original Message- From: Code for Libraries [mailto:CODE4LIB@LISTSERV.ND.EDU] On Behalf Of Jonathan Rochkind Sent: Thursday, November 01, 2012 4:57 PM To: CODE4LIB@LISTSERV.ND.EDU Subject: Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library? http://journal.code4lib.org On 11/1/2012 4:24 PM, Bohyun Kim wrote: Hi all code4lib-bers, As coders and coding librarians, what is ONE tool and/or resource that you recommend to newbie coders in a library (and why)? I promise I will create and circulate the list and make it into a Code4Lib wiki page for collective wisdom. =) Thanks in advance! Bohyun --- Bohyun Kim, MA, MSLIS Digital Access Librarian bohyun@fiu.edu 305-348-1471 Medical Library, College of Medicine Florida International University http://medlib.fiu.edu http://medlib.fiu.edu/m (Mobile) -- Nate Hill nathanielh...@gmail.com http://4thfloor.chattlibrary.org/ http://www.natehill.net
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
It's hard for me to list just one because, ehm, I get over-geeky about this stuff. Coders need an excellent text-editor - and the best one IMHO is Sublime Text 2 (www.sublimetext.com). Oh, okay, I can't resist - I'm going to cheat and list a second: everyone needs to stop writing just CSS and complement it with SASS (syntactically awesome stylesheets) Compass - http://sass-lang.com/. Totally invaluable for any front-end work. It makes CSS fun. Michael Schofield(@nova.edu) | Web Services Librarian | (954) 262-4536 Alvin Sherman Library, Research, and Information Technology Center -Original Message- From: Code for Libraries [mailto:CODE4LIB@LISTSERV.ND.EDU] On Behalf Of Bohyun Kim Sent: Thursday, November 01, 2012 4:25 PM To: CODE4LIB@LISTSERV.ND.EDU Subject: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library? Hi all code4lib-bers, As coders and coding librarians, what is ONE tool and/or resource that you recommend to newbie coders in a library (and why)? I promise I will create and circulate the list and make it into a Code4Lib wiki page for collective wisdom. =) Thanks in advance! Bohyun --- Bohyun Kim, MA, MSLIS Digital Access Librarian bohyun@fiu.edu 305-348-1471 Medical Library, College of Medicine Florida International University http://medlib.fiu.edu http://medlib.fiu.edu/m (Mobile)
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
Google is more useful than any reference book to find answers to programming problems. On Nov 1, 2012 4:25 PM, Bohyun Kim k...@fiu.edu wrote: Hi all code4lib-bers, As coders and coding librarians, what is ONE tool and/or resource that you recommend to newbie coders in a library (and why)? I promise I will create and circulate the list and make it into a Code4Lib wiki page for collective wisdom. =) Thanks in advance! Bohyun --- Bohyun Kim, MA, MSLIS Digital Access Librarian bohyun@fiu.edu 305-348-1471 Medical Library, College of Medicine Florida International University http://medlib.fiu.edu http://medlib.fiu.edu/m (Mobile)
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
Also the most useless. -Original Message- From: Code for Libraries [mailto:CODE4LIB@LISTSERV.ND.EDU] On Behalf Of Ethan Gruber Sent: Thursday, November 01, 2012 2:03 PM To: CODE4LIB@LISTSERV.ND.EDU Subject: Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library? Google is more useful than any reference book to find answers to programming problems. On Nov 1, 2012 4:25 PM, Bohyun Kim k...@fiu.edu wrote: Hi all code4lib-bers, As coders and coding librarians, what is ONE tool and/or resource that you recommend to newbie coders in a library (and why)? I promise I will create and circulate the list and make it into a Code4Lib wiki page for collective wisdom. =) Thanks in advance! Bohyun --- Bohyun Kim, MA, MSLIS Digital Access Librarian bohyun@fiu.edu 305-348-1471 Medical Library, College of Medicine Florida International University http://medlib.fiu.edu http://medlib.fiu.edu/m (Mobile)
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
Huh. Michael, I'd love to know more about why I should care about SASS. I kinda like writing CSS. I see why LESS http://lesscss.org/ makes sense, but help me under stand why SASS does? On Thu, Nov 1, 2012 at 5:02 PM, Ethan Gruber ewg4x...@gmail.com wrote: Google is more useful than any reference book to find answers to programming problems. On Nov 1, 2012 4:25 PM, Bohyun Kim k...@fiu.edu wrote: Hi all code4lib-bers, As coders and coding librarians, what is ONE tool and/or resource that you recommend to newbie coders in a library (and why)? I promise I will create and circulate the list and make it into a Code4Lib wiki page for collective wisdom. =) Thanks in advance! Bohyun --- Bohyun Kim, MA, MSLIS Digital Access Librarian bohyun@fiu.edu 305-348-1471 Medical Library, College of Medicine Florida International University http://medlib.fiu.edu http://medlib.fiu.edu/m (Mobile) -- Nate Hill nathanielh...@gmail.com http://4thfloor.chattlibrary.org/ http://www.natehill.net
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
foss4lib is a good resource that I'm sure many use, but isn't (as far as I can tell) linked anywhere on the current code4lib site. How would this differentiate itself from that? Kam On Nov 1, 2012 5:00 PM, Bohyun Kim k...@fiu.edu wrote: Do you all really want a C4L wiki page that lists c4l and c4l journal on top of recommended resources? I bet you do, but let's try some diversity, shall we? ~Bohyun -Original Message- From: Code for Libraries [mailto:CODE4LIB@LISTSERV.ND.EDU] On Behalf Of Jonathan Rochkind Sent: Thursday, November 01, 2012 4:57 PM To: CODE4LIB@LISTSERV.ND.EDU Subject: Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library? http://journal.code4lib.org On 11/1/2012 4:24 PM, Bohyun Kim wrote: Hi all code4lib-bers, As coders and coding librarians, what is ONE tool and/or resource that you recommend to newbie coders in a library (and why)? I promise I will create and circulate the list and make it into a Code4Lib wiki page for collective wisdom. =) Thanks in advance! Bohyun --- Bohyun Kim, MA, MSLIS Digital Access Librarian bohyun@fiu.edu 305-348-1471 Medical Library, College of Medicine Florida International University http://medlib.fiu.edu http://medlib.fiu.edu/m (Mobile)
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
I can already feel the collective rolling of eyes for this, but what about Twitter? It's not a guide or manual, but start following and engaging talented developers and library geeks on Twitter and you'll soon have more help than you know what to do with. Plus, no Zoia ;) -Dan On 11/1/12 2:00 PM, Bohyun Kim k...@fiu.edu wrote: Do you all really want a C4L wiki page that lists c4l and c4l journal on top of recommended resources? I bet you do, but let's try some diversity, shall we? ~Bohyun -Original Message- From: Code for Libraries [mailto:CODE4LIB@LISTSERV.ND.EDU] On Behalf Of Jonathan Rochkind Sent: Thursday, November 01, 2012 4:57 PM To: CODE4LIB@LISTSERV.ND.EDU Subject: Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library? http://journal.code4lib.org On 11/1/2012 4:24 PM, Bohyun Kim wrote: Hi all code4lib-bers, As coders and coding librarians, what is ONE tool and/or resource that you recommend to newbie coders in a library (and why)? I promise I will create and circulate the list and make it into a Code4Lib wiki page for collective wisdom. =) Thanks in advance! Bohyun --- Bohyun Kim, MA, MSLIS Digital Access Librarian bohyun@fiu.edu 305-348-1471 Medical Library, College of Medicine Florida International University http://medlib.fiu.edu http://medlib.fiu.edu/m (Mobile)
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
On Nov 1, 2012, at 5:02 PM, Ethan Gruber wrote: Google is more useful than any reference book to find answers to programming problems. Too bad they got rid of codesearch. On Nov 1, 2012, at 5:06 PM, Nate Hill wrote: Huh. Michael, I'd love to know more about why I should care about SASS. I kinda like writing CSS. I see why LESS http://lesscss.org/ makes sense, but help me under stand why SASS does? For the most part, using *any* CSS pre-processor is better than not using one. LESS's problem was that it's javascript based ... so if they have JS off ... you've got nothing. And it's got to be done for each user, rather than re-generate the files after you've made a modification. You can get around this with the 'lessc' compiler, and serve valid css files rather than having each client have to do the processing. They've also got different syntaxes, so it's really up to which one makes sense to you. Functionality wise ... I think they're about equal these days. I suspect that if one comes up with a useful new feature, the other group will copy it. On Nov 1, 2012, at 5:21 PM, Suchy, Daniel wrote: I can already feel the collective rolling of eyes for this, but what about Twitter? It's not a guide or manual, but start following and engaging talented developers and library geeks on Twitter and you'll soon have more help than you know what to do with. Plus, no Zoia ;) Too much misinformation: http://twitter.com/danhooker/status/5630099300 On Nov 1, 2012, at 5:06 PM, Kam Woods wrote: foss4lib is a good resource that I'm sure many use, but isn't (as far as I can tell) linked anywhere on the current code4lib site. How would this differentiate itself from that? The best tool isn't necessarily free or open source. (and it isn't necessarily software). So that being said ... my whiteboard. And a digital camera ... none of that 'smartboard' crap. -Joe
[CODE4LIB] SASS
Hi Nate,
I accept your challenge. For those reading who don't know,
SASS--Syntactically Awesome Style Sheets (www.sass-lang.com) --is a CSS
preprocessor. When bundled with COMPASS (http://compass-style.org/) I find
that it does a few things:
1.) Helps write DRYer CSS
2.) Makes managing huge site-wide stylesheets easy
3.) Helps write CSS faster.
4.) um, variables.
5.) math.
Less does all this, too - but IMHO SASS is much more robust and
user-friendly. Oh, Chris Coyier (www.css-tricks.com) agrees
(http://css-tricks.com/sass-vs-less/). He does a very thorough, perk-by-perk
breakdown and ultimately concludes with SASS. I guess, ultimately, use what
you like. Here's my take:
We have to adhere to our institutional color scheme. We use about ten colors
that periodically get changed. As you probably know, running through your
CSS to find and change hex color codes can be a pain. With SASS, you can
store all of your colors as variables and have to only change them once. For
example:
$light-blue: #50AFDF;
$dark-blue: #006699;
a { color: $dark-blue; }
SCSS (Sassy CSS) is exactly the same syntax as CSS. So the best way to start
using SASS is to just write CSS. Normally, for hover / focus / active
effects, you would have to write a:hover. With SCSS you can nest
a {
color: $dark-blue;
:hover, :active, :focus {
color: $light-blue;
}
}
I've started getting away from hex colors, but I have a hard time looking-up
rgba. SASS does it for me:
color: rgba($dark-blue);
Which, if you remember, I stored as a hex value. It also helps me pick a
consistent hover/active effect without having to have predefined light
blue. I could just do
color: lighten($dark-blue, 9%);
The most important thing for me is the ability to organize. For best
performance, you usually want just 1 CSS file. There are a lot of parts of
the CSS that are modular and benefit from being reused. So, what you can do,
is make up as many modular .scss files as needed and import them into a main
stylesheet. @importing in SCSS isn't like in CSS, because the compiler will
take all your different chunks and output one compressed CSS file. My folder
structure usually looks like this
_normalize.scss
_mixins.scss
_base.scss
_481up.scss
_grid.scss
_768up.scss
_1030up.scss
styles.scss
The underscore tells the preprocessor not to compile and output individual,
mini-CSS files. All it outputs is a single styles.css file. This also makes
for an easy mobile-first stylesheet, because you @import into styles.css
first the normalize/mixins/base styles, and then the rest import into
appropriate mediaqueries. Styles.css might look like
@media only screen and (min-width: 768) {
@import 'grid';
@import '768up';
}
Other things: @extending a class rather than repeating styles (again, DRY).
Utilizing @includes and mixins to write prefix free CSS3 (the resulting CSS
is packaged with all the prefixes).
... at this point, my wife comes around to pick me up from work. But, Nate
(and whomever else), I think this is definitely a useful bandwagon to jump
on. Again, see: http://css-tricks.com/sass-vs-less/
All the best,
Michael Schofield
-Original Message-
From: Code for Libraries [mailto:CODE4LIB@LISTSERV.ND.EDU] On Behalf Of Nate
Hill
Sent: Thursday, November 01, 2012 5:06 PM
To: CODE4LIB@LISTSERV.ND.EDU
Subject: Re: [CODE4LIB] one tool and/or resource that you recommend to
newbie coders in a library?
Huh. Michael, I'd love to know more about why I should care about SASS.
I kinda like writing CSS.
I see why LESS http://lesscss.org/ makes sense, but help me under stand why
SASS does?
On Thu, Nov 1, 2012 at 5:02 PM, Ethan Gruber ewg4x...@gmail.com wrote:
Google is more useful than any reference book to find answers to
programming problems.
On Nov 1, 2012 4:25 PM, Bohyun Kim k...@fiu.edu wrote:
Hi all code4lib-bers,
As coders and coding librarians, what is ONE tool and/or resource
that
you
recommend to newbie coders in a library (and why)? I promise I will
create
and circulate the list and make it into a Code4Lib wiki page for
collective
wisdom. =)
Thanks in advance!
Bohyun
---
Bohyun Kim, MA, MSLIS
Digital Access Librarian
bohyun@fiu.edu
305-348-1471
Medical Library, College of Medicine Florida International
University http://medlib.fiu.edu http://medlib.fiu.edu/m (Mobile)
--
Nate Hill
nathanielh...@gmail.com
http://4thfloor.chattlibrary.org/
http://www.natehill.net
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
Version control. My own strong preference is for git (either managed locally or through github.com), but really, just pick a version control solution and use it. If you value your work at all, it should be in version control. Smart use of version control can make finding and fixing problems in code much, much easier - but even fairly naive use of it leaves you with much, much better tools for fixing screw ups than you have without it. - Dave Mayo On Thu, Nov 1, 2012 at 5:31 PM, Joe Hourcle onei...@grace.nascom.nasa.govwrote: On Nov 1, 2012, at 5:02 PM, Ethan Gruber wrote: Google is more useful than any reference book to find answers to programming problems. Too bad they got rid of codesearch. On Nov 1, 2012, at 5:06 PM, Nate Hill wrote: Huh. Michael, I'd love to know more about why I should care about SASS. I kinda like writing CSS. I see why LESS http://lesscss.org/ makes sense, but help me under stand why SASS does? For the most part, using *any* CSS pre-processor is better than not using one. LESS's problem was that it's javascript based ... so if they have JS off ... you've got nothing. And it's got to be done for each user, rather than re-generate the files after you've made a modification. You can get around this with the 'lessc' compiler, and serve valid css files rather than having each client have to do the processing. They've also got different syntaxes, so it's really up to which one makes sense to you. Functionality wise ... I think they're about equal these days. I suspect that if one comes up with a useful new feature, the other group will copy it. On Nov 1, 2012, at 5:21 PM, Suchy, Daniel wrote: I can already feel the collective rolling of eyes for this, but what about Twitter? It's not a guide or manual, but start following and engaging talented developers and library geeks on Twitter and you'll soon have more help than you know what to do with. Plus, no Zoia ;) Too much misinformation: http://twitter.com/danhooker/status/5630099300 On Nov 1, 2012, at 5:06 PM, Kam Woods wrote: foss4lib is a good resource that I'm sure many use, but isn't (as far as I can tell) linked anywhere on the current code4lib site. How would this differentiate itself from that? The best tool isn't necessarily free or open source. (and it isn't necessarily software). So that being said ... my whiteboard. And a digital camera ... none of that 'smartboard' crap. -Joe
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
Apologies, everyone (and especially Bohyun). You may still want to consider pointing people to foss4lib as a useful resource, but amend it with the following statement: Free and open source tools may not be the best tools. You might not even NEED software to handle whatever problem you have. Please consider contacting onei...@grace.nascom.nasa.gov for further insight. Personally, I was unaware of either of these issues. It's a good thing I came here today for some edification. On Thu, Nov 1, 2012 at 5:31 PM, Joe Hourcle onei...@grace.nascom.nasa.govwrote: On Nov 1, 2012, at 5:02 PM, Ethan Gruber wrote: Google is more useful than any reference book to find answers to programming problems. Too bad they got rid of codesearch. On Nov 1, 2012, at 5:06 PM, Nate Hill wrote: Huh. Michael, I'd love to know more about why I should care about SASS. I kinda like writing CSS. I see why LESS http://lesscss.org/ makes sense, but help me under stand why SASS does? For the most part, using *any* CSS pre-processor is better than not using one. LESS's problem was that it's javascript based ... so if they have JS off ... you've got nothing. And it's got to be done for each user, rather than re-generate the files after you've made a modification. You can get around this with the 'lessc' compiler, and serve valid css files rather than having each client have to do the processing. They've also got different syntaxes, so it's really up to which one makes sense to you. Functionality wise ... I think they're about equal these days. I suspect that if one comes up with a useful new feature, the other group will copy it. On Nov 1, 2012, at 5:21 PM, Suchy, Daniel wrote: I can already feel the collective rolling of eyes for this, but what about Twitter? It's not a guide or manual, but start following and engaging talented developers and library geeks on Twitter and you'll soon have more help than you know what to do with. Plus, no Zoia ;) Too much misinformation: http://twitter.com/danhooker/status/5630099300 On Nov 1, 2012, at 5:06 PM, Kam Woods wrote: foss4lib is a good resource that I'm sure many use, but isn't (as far as I can tell) linked anywhere on the current code4lib site. How would this differentiate itself from that? The best tool isn't necessarily free or open source. (and it isn't necessarily software). So that being said ... my whiteboard. And a digital camera ... none of that 'smartboard' crap. -Joe
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
On Nov 1, 2012, at 6:56 PM, Kam Woods wrote: Apologies, everyone (and especially Bohyun). You may still want to consider pointing people to foss4lib as a useful resource, but amend it with the following statement: Free and open source tools may not be the best tools. You might not even NEED software to handle whatever problem you have. Please consider contacting onei...@grace.nascom.nasa.gov for further insight. Oh ... sure... just get me in trouble ... We're supposed to use our 'OneNASA' e-mail address, so you'd have to change it to joseph.a.hour...@nasa.gov ... and I said that in part as I've been in the past a beta tester for BareBones's BBEdit. If you're not doing HTML work, TextWrangler will probably do what you need (which is ... whatever the 'free' is that isn't 'libre') And there's plenty of other good software out there that isn't free, and there's lots of free software out there that's crap (some of which I might've been involved with). Personally, I was unaware of either of these issues. It's a good thing I came here today for some edification. Yes. 'smart' whiteboards are over priced crap. I hope I've educated everyone today. -Joe
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
I won't expand on Michael's excellent summary of using SASS, but he did
leave out one crucial bit -- it comes in two formats, which causes some
confusion. The format that Michael was describing is the second one, SCSS,
which is basically CSS with some fancy nesting patterns that you can't do
natively in CSS, as well as variables and math functions. The original
format, SASS, omitted the {} braces and used a whitespace indenting style,
purposely emulating Ruby and Python in that regard. SCSS has the shorter
learning curve and, in fact, you can just use your usual CSS to get started
go on from there. In SASS, you have to refactor all your old CSS to the new
format, but my understanding is that there may be some things you can do in
SASS that you can't do in SCSS (not sure what, though).
On Thu, Nov 1, 2012 at 5:06 PM, Nate Hill nathanielh...@gmail.com wrote:
Huh. Michael, I'd love to know more about why I should care about SASS.
I kinda like writing CSS.
I see why LESS http://lesscss.org/ makes sense, but help me under stand
why
SASS does?
On Thu, Nov 1, 2012 at 5:02 PM, Ethan Gruber ewg4x...@gmail.com wrote:
Google is more useful than any reference book to find answers to
programming problems.
On Nov 1, 2012 4:25 PM, Bohyun Kim k...@fiu.edu wrote:
Hi all code4lib-bers,
As coders and coding librarians, what is ONE tool and/or resource that
you
recommend to newbie coders in a library (and why)? I promise I will
create
and circulate the list and make it into a Code4Lib wiki page for
collective
wisdom. =)
Thanks in advance!
Bohyun
---
Bohyun Kim, MA, MSLIS
Digital Access Librarian
bohyun@fiu.edu
305-348-1471
Medical Library, College of Medicine
Florida International University
http://medlib.fiu.edu
http://medlib.fiu.edu/m (Mobile)
--
Nate Hill
nathanielh...@gmail.com
http://4thfloor.chattlibrary.org/
http://www.natehill.net
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
And here's my coding tool, which is supported by most of the common code editors via plugins: Zen Coding, http://code.google.com/p/zen-coding/ The idea is that it lets you use CSS-like selectors as tags that can be expanded into full HTML snippets. I'll just use the example from the project page to describe what I mean. You type a string like this ... div#pagediv.logo+ul#navigationli*5a ... and Zen Coding will expand it into: div id=page div class=logo/div ul id=navigation lia href=/a/li lia href=/a/li lia href=/a/li lia href=/a/li lia href=/a/li /ul /div
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
This is my goto resource — http://en.wikipedia.org/wiki/Booker's On Thu, Nov 1, 2012 at 4:44 PM, Tom Keays tomke...@gmail.com wrote: And here's my coding tool, which is supported by most of the common code editors via plugins: Zen Coding, http://code.google.com/p/zen-coding/ The idea is that it lets you use CSS-like selectors as tags that can be expanded into full HTML snippets. I'll just use the example from the project page to describe what I mean. You type a string like this ... div#pagediv.logo+ul#navigationli*5a ... and Zen Coding will expand it into: div id=page div class=logo/div ul id=navigation lia href=/a/li lia href=/a/li lia href=/a/li lia href=/a/li lia href=/a/li /ul /div -- Cary Gordon The Cherry Hill Company http://chillco.com
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
Link juice for search engines! On Thu, Nov 1, 2012 at 4:00 PM, Bohyun Kim k...@fiu.edu wrote: Do you all really want a C4L wiki page that lists c4l and c4l journal on top of recommended resources? I bet you do, but let's try some diversity, shall we? ~Bohyun -Original Message- From: Code for Libraries [mailto:CODE4LIB@LISTSERV.ND.EDU] On Behalf Of Jonathan Rochkind Sent: Thursday, November 01, 2012 4:57 PM To: CODE4LIB@LISTSERV.ND.EDU Subject: Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library? http://journal.code4lib.org On 11/1/2012 4:24 PM, Bohyun Kim wrote: Hi all code4lib-bers, As coders and coding librarians, what is ONE tool and/or resource that you recommend to newbie coders in a library (and why)? I promise I will create and circulate the list and make it into a Code4Lib wiki page for collective wisdom. =) Thanks in advance! Bohyun --- Bohyun Kim, MA, MSLIS Digital Access Librarian bohyun@fiu.edu 305-348-1471 Medical Library, College of Medicine Florida International University http://medlib.fiu.edu http://medlib.fiu.edu/m (Mobile)
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
The number one tool I think a newbie coder should get is a cheapie online webhosting account - like a $10 a month one - and multiple URLs. Multiple URLs will make them point a URL at a nameserver at least once ideally, and to understand that the two are separate and what you can do with domains and subdomains. The cheapie webhosting account will let them play with installing popular content management systems manually and with one-click installs. The most important thing is to break things and then rebuild them. The worst possible thing would be to build a website, leave it up as their public face or personal website, and be nervous to wreck it so not change or play with different CMSes (another reason multiple URLs might psychologically be better - they encourage experimentation on one and the person can make the other a static goal oriented publishing area). The more the cheapie hosting account experience I have, the more I know what's cheap and easy to do, and the more I see very specific benefits to a dedicated server. It makes me more intentional and able to better assess the value of services vendors provide. That's more web4lib ish, but ultimately if someone experiments enough they have to get comfortable with php. Scripting is the gateway drug. -Wilhelmina Randtke On Thu, Nov 1, 2012 at 3:24 PM, Bohyun Kim k...@fiu.edu wrote: Hi all code4lib-bers, As coders and coding librarians, what is ONE tool and/or resource that you recommend to newbie coders in a library (and why)? I promise I will create and circulate the list and make it into a Code4Lib wiki page for collective wisdom. =) Thanks in advance! Bohyun --- Bohyun Kim, MA, MSLIS Digital Access Librarian bohyun@fiu.edu 305-348-1471 Medical Library, College of Medicine Florida International University http://medlib.fiu.edu http://medlib.fiu.edu/m (Mobile)
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
My 2 cents worth ... and one for each cent: * Komodo Edit * www.w3.org/International On 2 November 2012 07:24, Bohyun Kim k...@fiu.edu wrote: Hi all code4lib-bers, As coders and coding librarians, what is ONE tool and/or resource that you recommend to newbie coders in a library (and why)? I promise I will create and circulate the list and make it into a Code4Lib wiki page for collective wisdom. =) Thanks in advance! Bohyun --- Bohyun Kim, MA, MSLIS Digital Access Librarian bohyun@fiu.edu 305-348-1471 Medical Library, College of Medicine Florida International University http://medlib.fiu.edu http://medlib.fiu.edu/m (Mobile) -- Andrew Cunningham Project Manager, Research and Development Social and Digital Inclusion Unit Public Libraries and Community Engagement State Library of Victoria 328 Swanston Street Melbourne VIC 3000 Australia Ph: +61-3-8664-7430 Mobile: 0459 806 589 Email: acunning...@slv.vic.gov.au lang.supp...@gmail.com http://www.openroad.net.au/ http://www.mylanguage.gov.au/ http://www.slv.vic.gov.au/
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
I'm taking tool to mean a piece of hardware. I'd recommend some old laptop with your favorite linux distro less desktop. Why? Well the main thing is that it puts them into a position where they're not learning to be a google copy/paste coder given the lack of the desktop, mouse and distractions like email. They can also learn to setup the server environment on their new dev box and eventually do all sorts of cool stuff. ___ Michael Friscia Manager, Digital Library Programming Services Yale University Library (203) 432-1856 From: Code for Libraries [CODE4LIB@LISTSERV.ND.EDU] on behalf of Bohyun Kim [k...@fiu.edu] Sent: Thursday, November 01, 2012 4:24 PM To: CODE4LIB@LISTSERV.ND.EDU Subject: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library? Hi all code4lib-bers, As coders and coding librarians, what is ONE tool and/or resource that you recommend to newbie coders in a library (and why)? I promise I will create and circulate the list and make it into a Code4Lib wiki page for collective wisdom. =) Thanks in advance! Bohyun --- Bohyun Kim, MA, MSLIS Digital Access Librarian bohyun@fiu.edu 305-348-1471 Medical Library, College of Medicine Florida International University http://medlib.fiu.edu http://medlib.fiu.edu/m (Mobile)
[CODE4LIB] Writing good documentation
You all do this right? ;-) Aside from Wiki's can anyone recommend any freely available document creating tools. Eric Hellman's[0] post this AM spurred this. My (Our?) goal is an easy way to create How-To like Documentation geared towards a novice. I've looked at Dozuki[1] but would rather not pay. Thanks in advance El Cheapo ./fxk [0] http://serials.infomotions.com/code4lib/archive/2012/201211/3106.html [1] http://www.dozuki.com/ -- It looks like blind screaming hedonism won out.
Re: [CODE4LIB] SASS
friggin' awesome Michael. thanks for your clear explanation!
i'll try out SASS :)
On Thu, Nov 1, 2012 at 6:03 PM, Michael Schofield mschofi...@nova.eduwrote:
Hi Nate,
I accept your challenge. For those reading who don't know,
SASS--Syntactically Awesome Style Sheets (www.sass-lang.com) --is a CSS
preprocessor. When bundled with COMPASS (http://compass-style.org/) I find
that it does a few things:
1.) Helps write DRYer CSS
2.) Makes managing huge site-wide stylesheets easy
3.) Helps write CSS faster.
4.) um, variables.
5.) math.
Less does all this, too - but IMHO SASS is much more robust and
user-friendly. Oh, Chris Coyier (www.css-tricks.com) agrees
(http://css-tricks.com/sass-vs-less/). He does a very thorough,
perk-by-perk
breakdown and ultimately concludes with SASS. I guess, ultimately, use what
you like. Here's my take:
We have to adhere to our institutional color scheme. We use about ten
colors
that periodically get changed. As you probably know, running through your
CSS to find and change hex color codes can be a pain. With SASS, you can
store all of your colors as variables and have to only change them once.
For
example:
$light-blue: #50AFDF;
$dark-blue: #006699;
a { color: $dark-blue; }
SCSS (Sassy CSS) is exactly the same syntax as CSS. So the best way to
start
using SASS is to just write CSS. Normally, for hover / focus / active
effects, you would have to write a:hover. With SCSS you can nest
a {
color: $dark-blue;
:hover, :active, :focus {
color: $light-blue;
}
}
I've started getting away from hex colors, but I have a hard time
looking-up
rgba. SASS does it for me:
color: rgba($dark-blue);
Which, if you remember, I stored as a hex value. It also helps me pick a
consistent hover/active effect without having to have predefined light
blue. I could just do
color: lighten($dark-blue, 9%);
The most important thing for me is the ability to organize. For best
performance, you usually want just 1 CSS file. There are a lot of parts of
the CSS that are modular and benefit from being reused. So, what you can
do,
is make up as many modular .scss files as needed and import them into a
main
stylesheet. @importing in SCSS isn't like in CSS, because the compiler will
take all your different chunks and output one compressed CSS file. My
folder
structure usually looks like this
_normalize.scss
_mixins.scss
_base.scss
_481up.scss
_grid.scss
_768up.scss
_1030up.scss
styles.scss
The underscore tells the preprocessor not to compile and output individual,
mini-CSS files. All it outputs is a single styles.css file. This also makes
for an easy mobile-first stylesheet, because you @import into styles.css
first the normalize/mixins/base styles, and then the rest import into
appropriate mediaqueries. Styles.css might look like
@media only screen and (min-width: 768) {
@import 'grid';
@import '768up';
}
Other things: @extending a class rather than repeating styles (again, DRY).
Utilizing @includes and mixins to write prefix free CSS3 (the resulting CSS
is packaged with all the prefixes).
... at this point, my wife comes around to pick me up from work. But, Nate
(and whomever else), I think this is definitely a useful bandwagon to jump
on. Again, see: http://css-tricks.com/sass-vs-less/
All the best,
Michael Schofield
-Original Message-
From: Code for Libraries [mailto:CODE4LIB@LISTSERV.ND.EDU] On Behalf Of
Nate
Hill
Sent: Thursday, November 01, 2012 5:06 PM
To: CODE4LIB@LISTSERV.ND.EDU
Subject: Re: [CODE4LIB] one tool and/or resource that you recommend to
newbie coders in a library?
Huh. Michael, I'd love to know more about why I should care about SASS.
I kinda like writing CSS.
I see why LESS http://lesscss.org/ makes sense, but help me under stand
why
SASS does?
On Thu, Nov 1, 2012 at 5:02 PM, Ethan Gruber ewg4x...@gmail.com wrote:
Google is more useful than any reference book to find answers to
programming problems.
On Nov 1, 2012 4:25 PM, Bohyun Kim k...@fiu.edu wrote:
Hi all code4lib-bers,
As coders and coding librarians, what is ONE tool and/or resource
that
you
recommend to newbie coders in a library (and why)? I promise I will
create
and circulate the list and make it into a Code4Lib wiki page for
collective
wisdom. =)
Thanks in advance!
Bohyun
---
Bohyun Kim, MA, MSLIS
Digital Access Librarian
bohyun@fiu.edu
305-348-1471
Medical Library, College of Medicine Florida International
University http://medlib.fiu.edu http://medlib.fiu.edu/m (Mobile)
--
Nate Hill
nathanielh...@gmail.com
http://4thfloor.chattlibrary.org/
http://www.natehill.net
--
Nate Hill
nathanielh...@gmail.com
http://4thfloor.chattlibrary.org/
http://www.natehill.net
Re: [CODE4LIB] Writing good documentation
Our shop uses Org mode, http://orgmode.org/ . It makes you want to write documentation (and we do). :-) -- Charles Blair Director, Digital Library Development Center, University of Chicago Library 1 773 702 8459 | c...@uchicago.edu | http://www.lib.uchicago.edu/~chas/
Re: [CODE4LIB] one tool and/or resource that you recommend to newbie coders in a library?
Bohyun Kim k...@fiu.edu wrote: Hi all code4lib-bers, As coders and coding librarians, what is ONE tool and/or resource that you recommend to newbie coders in a library (and why)? I promise I will create and circulate the list and make it into a Code4Lib wiki page for collective wisdom. =) How to Design Programs is online at http://www.ccs.neu.edu/home/matthias/HtDP2e/. Good for newbie coders. StackOverflow.com is a great site for questions. Also a pretty good list at http://grokcode.com/11/the-top-9-in-a-hackers-bookshelf/ Bill
Re: [CODE4LIB] Writing good documentation
We like wikis, and do a lot of documentation in Confluence. For lower budgets, like our own, we use Google sites. For novices, we use Screenflow to create screencasts. They are very well received. Cary On Thu, Nov 1, 2012 at 6:37 PM, Francis Kayiwa kay...@uic.edu wrote: You all do this right? ;-) Aside from Wiki's can anyone recommend any freely available document creating tools. Eric Hellman's[0] post this AM spurred this. My (Our?) goal is an easy way to create How-To like Documentation geared towards a novice. I've looked at Dozuki[1] but would rather not pay. Thanks in advance El Cheapo ./fxk [0] http://serials.infomotions.com/code4lib/archive/2012/201211/3106.html [1] http://www.dozuki.com/ -- It looks like blind screaming hedonism won out. -- Cary Gordon The Cherry Hill Company http://chillco.com
Re: [CODE4LIB] Writing good documentation
Francis Kayiwa kay...@uic.edu wrote: Aside from Wiki's can anyone recommend any freely available document creating tools. Eric Hellman's[0] post this AM spurred this. My (Our?) goal is an easy way to create How-To like Documentation geared towards a novice. GNU Emacs (http://www.gnu.org/software/emacs/) is the Swiss army knife of document creation tools. Bill
